{ "schemaVersion": "1.0", "item": { "slug": "octolens", "name": "Octolens", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/garrrikkotua/octolens", "canonicalUrl": "https://clawhub.ai/garrrikkotua/octolens", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/octolens", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=octolens", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "references/EXAMPLES.md", "references/FILTERS.md", "scripts/README.md", "scripts/advanced-query.js", "scripts/fetch-mentions.js" ], "primaryDoc": "SKILL.md", "quickSetup": [ "Download the package from Yavira.", "Extract the archive and review SKILL.md first.", "Import or place the package into your OpenClaw setup." ], "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/octolens" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] }, "downloadPageUrl": "https://openagent3.xyz/downloads/octolens", "agentPageUrl": "https://openagent3.xyz/skills/octolens/agent", "manifestUrl": "https://openagent3.xyz/skills/octolens/agent.json", "briefUrl": "https://openagent3.xyz/skills/octolens/agent.md" }, "agentAssist": { "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.", "steps": [ "Download the package from Yavira.", "Extract it into a folder your agent can access.", "Paste one of the prompts below and point your agent at the extracted folder." ], "prompts": [ { "label": "New install", "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete." }, { "label": "Upgrade existing", "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "When to use this skill", "body": "Use this skill when the user needs to:\n\nFetch brand mentions from social media and other platforms\nFilter mentions by source (Twitter, Reddit, GitHub, LinkedIn, YouTube, HackerNews, DevTO, StackOverflow, Bluesky, newsletters, podcasts)\nAnalyze sentiment (positive, neutral, negative)\nFilter by author follower count or engagement\nSearch for specific keywords or tags\nQuery mentions by date range\nList available keywords or saved views\nApply complex filtering logic with AND/OR conditions" }, { "title": "API Authentication", "body": "The Octolens API requires a Bearer token for authentication. The user should provide their API key, which you'll use in the Authorization header:\n\nAuthorization: Bearer YOUR_API_KEY\n\nImportant: Always ask the user for their API key before making any API calls. Store it in a variable for subsequent requests." }, { "title": "Base URL", "body": "All API endpoints use the base URL: https://app.octolens.com/api/v1" }, { "title": "Rate Limits", "body": "Limit: 500 requests per hour\nCheck headers: X-RateLimit-* headers indicate current usage" }, { "title": "1. POST /mentions", "body": "Fetch mentions matching keywords with optional filtering. Returns posts sorted by timestamp (newest first).\n\nKey Parameters:\n\nlimit (number, 1-100): Maximum results to return (default: 20)\ncursor (string): Pagination cursor from previous response\nincludeAll (boolean): Include low-relevance posts (default: false)\nview (number): View ID to use for filtering\nfilters (object): Filter criteria (see filtering section)\n\nExample Response:\n\n{\n \"data\": [\n {\n \"id\": \"abc123\",\n \"url\": \"https://twitter.com/user/status/123\",\n \"body\": \"Just discovered @YourProduct - this is exactly what I needed!\",\n \"source\": \"twitter\",\n \"timestamp\": \"2024-01-15T10:30:00Z\",\n \"author\": \"user123\",\n \"authorName\": \"John Doe\",\n \"authorFollowers\": 5420,\n \"relevance\": \"relevant\",\n \"sentiment\": \"positive\",\n \"language\": \"en\",\n \"tags\": [\"feature-request\"],\n \"keywords\": [{ \"id\": 1, \"keyword\": \"YourProduct\" }],\n \"bookmarked\": false,\n \"engaged\": false\n }\n ],\n \"cursor\": \"eyJsYXN0SWQiOiAiYWJjMTIzIn0=\"\n}" }, { "title": "2. GET /keywords", "body": "List all keywords configured for the organization.\n\nExample Response:\n\n{\n \"data\": [\n {\n \"id\": 1,\n \"keyword\": \"YourProduct\",\n \"platforms\": [\"twitter\", \"reddit\", \"github\"],\n \"color\": \"#6366f1\",\n \"paused\": false,\n \"context\": \"Our main product name\"\n }\n ]\n}" }, { "title": "3. GET /views", "body": "List all saved views (pre-configured filters).\n\nExample Response:\n\n{\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"High Priority\",\n \"icon\": \"star\",\n \"filters\": {\n \"sentiment\": [\"positive\", \"negative\"],\n \"source\": [\"twitter\"]\n },\n \"createdAt\": \"2024-01-01T00:00:00Z\"\n }\n ]\n}" }, { "title": "Filtering Mentions", "body": "The /mentions endpoint supports powerful filtering with two modes:" }, { "title": "Simple Mode (Implicit AND)", "body": "Put fields directly in filters. All conditions are ANDed together.\n\n{\n \"filters\": {\n \"source\": [\"twitter\", \"linkedin\"],\n \"sentiment\": [\"positive\"],\n \"minXFollowers\": 1000\n }\n}\n\n→ source IN (twitter, linkedin) AND sentiment = positive AND followers ≥ 1000" }, { "title": "Exclusions", "body": "Prefix any array field with ! to exclude values:\n\n{\n \"filters\": {\n \"source\": [\"twitter\"],\n \"!keyword\": [5, 6]\n }\n}\n\n→ source = twitter AND keyword NOT IN (5, 6)" }, { "title": "Advanced Mode (AND/OR Groups)", "body": "Use operator and groups for complex logic:\n\n{\n \"filters\": {\n \"operator\": \"AND\",\n \"groups\": [\n {\n \"operator\": \"OR\",\n \"conditions\": [\n { \"source\": [\"twitter\"] },\n { \"source\": [\"linkedin\"] }\n ]\n },\n {\n \"operator\": \"AND\",\n \"conditions\": [\n { \"sentiment\": [\"positive\"] },\n { \"!tag\": [\"spam\"] }\n ]\n }\n ]\n }\n}\n\n→ (source = twitter OR source = linkedin) AND (sentiment = positive AND tag ≠ spam)" }, { "title": "Available Filter Fields", "body": "FieldTypeDescriptionsourcestring[]Platforms: twitter, reddit, github, linkedin, youtube, hackernews, devto, stackoverflow, bluesky, newsletter, podcastsentimentstring[]Values: positive, neutral, negativekeywordstring[]Keyword IDs (get from /keywords endpoint)languagestring[]ISO 639-1 codes: en, es, fr, de, pt, it, nl, ja, ko, zhtagstring[]Tag namesbookmarkedbooleanFilter bookmarked (true) or non-bookmarked (false) postsengagedbooleanFilter engaged (true) or non-engaged (false) postsminXFollowersnumberMinimum Twitter follower countmaxXFollowersnumberMaximum Twitter follower countstartDatestringISO 8601 format (e.g., \"2024-01-15T00:00:00Z\")endDatestringISO 8601 format" }, { "title": "Using the Bundled Scripts", "body": "This skill includes helper scripts for common operations. Use them to quickly interact with the API:" }, { "title": "Fetch Mentions", "body": "node scripts/fetch-mentions.js YOUR_API_KEY [limit] [includeAll]" }, { "title": "List Keywords", "body": "node scripts/list-keywords.js YOUR_API_KEY" }, { "title": "List Views", "body": "node scripts/list-views.js YOUR_API_KEY" }, { "title": "Custom Filter Query", "body": "node scripts/query-mentions.js YOUR_API_KEY '{\"source\": [\"twitter\"], \"sentiment\": [\"positive\"]}' [limit]" }, { "title": "Advanced Query", "body": "node scripts/advanced-query.js YOUR_API_KEY [limit]" }, { "title": "Best Practices", "body": "Always ask for the API key before making requests\nUse views when possible to leverage pre-configured filters\nStart with simple filters and add complexity as needed\nCheck rate limits in response headers (X-RateLimit-*)\nUse pagination with cursor for large result sets\nDates must be ISO 8601 format (e.g., \"2024-01-15T00:00:00Z\")\nGet keyword IDs from /keywords endpoint before filtering by keyword\nUse exclusions (!) to filter out unwanted content\nCombine includeAll=false with relevance filtering for quality results" }, { "title": "Find positive Twitter mentions with high followers", "body": "{\n \"limit\": 20,\n \"filters\": {\n \"source\": [\"twitter\"],\n \"sentiment\": [\"positive\"],\n \"minXFollowers\": 1000\n }\n}" }, { "title": "Exclude spam and get Reddit + GitHub mentions", "body": "{\n \"limit\": 50,\n \"filters\": {\n \"source\": [\"reddit\", \"github\"],\n \"!tag\": [\"spam\", \"irrelevant\"]\n }\n}" }, { "title": "Complex query: (Twitter OR LinkedIn) AND positive sentiment, last 7 days", "body": "{\n \"limit\": 30,\n \"filters\": {\n \"operator\": \"AND\",\n \"groups\": [\n {\n \"operator\": \"OR\",\n \"conditions\": [\n { \"source\": [\"twitter\"] },\n { \"source\": [\"linkedin\"] }\n ]\n },\n {\n \"operator\": \"AND\",\n \"conditions\": [\n { \"sentiment\": [\"positive\"] },\n { \"startDate\": \"2024-01-20T00:00:00Z\" }\n ]\n }\n ]\n }\n}" }, { "title": "Error Handling", "body": "StatusErrorDescription401unauthorizedMissing or invalid API key403forbiddenValid key but no permission404not_foundResource (e.g., view ID) not found429rate_limit_exceededToo many requests400invalid_requestMalformed request body500internal_errorServer error, retry later" }, { "title": "Step-by-Step Workflow", "body": "When a user asks to query Octolens data:\n\nAsk for API key if not already provided\nUnderstand the request: What are they looking for?\nDetermine filters needed: Source, sentiment, date range, etc.\nCheck if a view applies: List views first if user mentions saved filters\nBuild the query: Use simple mode first, advanced mode for complex logic\nExecute the request: Use bundled Node.js scripts or fetch API directly\nParse results: Extract key information (author, body, sentiment, source)\nHandle pagination: If more results needed, use cursor from response\nPresent findings: Summarize insights, highlight patterns" }, { "title": "Example 1: Simple Query", "body": "User: \"Show me positive mentions from Twitter in the last 7 days\"\n\nAction (using bundled script):\n\nnode scripts/query-mentions.js YOUR_API_KEY '{\"source\": [\"twitter\"], \"sentiment\": [\"positive\"], \"startDate\": \"2024-01-20T00:00:00Z\"}'\n\nAlternative (using fetch API directly):\n\nconst response = await fetch('https://app.octolens.com/api/v1/mentions', {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${API_KEY}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n limit: 20,\n filters: {\n source: ['twitter'],\n sentiment: ['positive'],\n startDate: '2024-01-20T00:00:00Z',\n },\n }),\n});\nconst data = await response.json();" }, { "title": "Example 2: Advanced Query", "body": "User: \"Find mentions from Reddit or GitHub, exclude spam tag, with positive or neutral sentiment\"\n\nAction (using bundled script):\n\nnode scripts/query-mentions.js YOUR_API_KEY '{\"operator\": \"AND\", \"groups\": [{\"operator\": \"OR\", \"conditions\": [{\"source\": [\"reddit\"]}, {\"source\": [\"github\"]}]}, {\"operator\": \"OR\", \"conditions\": [{\"sentiment\": [\"positive\"]}, {\"sentiment\": [\"neutral\"]}]}, {\"operator\": \"AND\", \"conditions\": [{\"!tag\": [\"spam\"]}]}]}'\n\nAlternative (using fetch API directly):\n\nconst response = await fetch('https://app.octolens.com/api/v1/mentions', {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${API_KEY}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n limit: 30,\n filters: {\n operator: 'AND',\n groups: [\n {\n operator: 'OR',\n conditions: [\n { source: ['reddit'] },\n { source: ['github'] },\n ],\n },\n {\n operator: 'OR',\n conditions: [\n { sentiment: ['positive'] },\n { sentiment: ['neutral'] },\n ],\n },\n {\n operator: 'AND',\n conditions: [\n { '!tag': ['spam'] },\n ],\n },\n ],\n },\n }),\n});\nconst data = await response.json();" }, { "title": "Example 3: Get Keywords First", "body": "User: \"Show mentions for our main product keyword\"\n\nActions:\n\nFirst, list keywords:\n\nnode scripts/list-keywords.js YOUR_API_KEY\n\nThen query mentions with the keyword ID:\n\nnode scripts/query-mentions.js YOUR_API_KEY '{\"keyword\": [1]}'" }, { "title": "Tips for Agents", "body": "Use bundled scripts: The Node.js scripts handle JSON parsing automatically\nCache keywords: After fetching keywords once, remember them for the session\nExplain filters: When using complex filters, explain the logic to the user\nShow examples: When users are unsure, show example filter structures\nPaginate wisely: Ask if user wants more results before fetching next page\nSummarize insights: Don't just dump data, provide analysis (sentiment trends, top authors, platform distribution)" } ], "body": "Octolens API Skill\nWhen to use this skill\n\nUse this skill when the user needs to:\n\nFetch brand mentions from social media and other platforms\nFilter mentions by source (Twitter, Reddit, GitHub, LinkedIn, YouTube, HackerNews, DevTO, StackOverflow, Bluesky, newsletters, podcasts)\nAnalyze sentiment (positive, neutral, negative)\nFilter by author follower count or engagement\nSearch for specific keywords or tags\nQuery mentions by date range\nList available keywords or saved views\nApply complex filtering logic with AND/OR conditions\nAPI Authentication\n\nThe Octolens API requires a Bearer token for authentication. The user should provide their API key, which you'll use in the Authorization header:\n\nAuthorization: Bearer YOUR_API_KEY\n\n\nImportant: Always ask the user for their API key before making any API calls. Store it in a variable for subsequent requests.\n\nBase URL\n\nAll API endpoints use the base URL: https://app.octolens.com/api/v1\n\nRate Limits\nLimit: 500 requests per hour\nCheck headers: X-RateLimit-* headers indicate current usage\nAvailable Endpoints\n1. POST /mentions\n\nFetch mentions matching keywords with optional filtering. Returns posts sorted by timestamp (newest first).\n\nKey Parameters:\n\nlimit (number, 1-100): Maximum results to return (default: 20)\ncursor (string): Pagination cursor from previous response\nincludeAll (boolean): Include low-relevance posts (default: false)\nview (number): View ID to use for filtering\nfilters (object): Filter criteria (see filtering section)\n\nExample Response:\n\n{\n \"data\": [\n {\n \"id\": \"abc123\",\n \"url\": \"https://twitter.com/user/status/123\",\n \"body\": \"Just discovered @YourProduct - this is exactly what I needed!\",\n \"source\": \"twitter\",\n \"timestamp\": \"2024-01-15T10:30:00Z\",\n \"author\": \"user123\",\n \"authorName\": \"John Doe\",\n \"authorFollowers\": 5420,\n \"relevance\": \"relevant\",\n \"sentiment\": \"positive\",\n \"language\": \"en\",\n \"tags\": [\"feature-request\"],\n \"keywords\": [{ \"id\": 1, \"keyword\": \"YourProduct\" }],\n \"bookmarked\": false,\n \"engaged\": false\n }\n ],\n \"cursor\": \"eyJsYXN0SWQiOiAiYWJjMTIzIn0=\"\n}\n\n2. GET /keywords\n\nList all keywords configured for the organization.\n\nExample Response:\n\n{\n \"data\": [\n {\n \"id\": 1,\n \"keyword\": \"YourProduct\",\n \"platforms\": [\"twitter\", \"reddit\", \"github\"],\n \"color\": \"#6366f1\",\n \"paused\": false,\n \"context\": \"Our main product name\"\n }\n ]\n}\n\n3. GET /views\n\nList all saved views (pre-configured filters).\n\nExample Response:\n\n{\n \"data\": [\n {\n \"id\": 1,\n \"name\": \"High Priority\",\n \"icon\": \"star\",\n \"filters\": {\n \"sentiment\": [\"positive\", \"negative\"],\n \"source\": [\"twitter\"]\n },\n \"createdAt\": \"2024-01-01T00:00:00Z\"\n }\n ]\n}\n\nFiltering Mentions\n\nThe /mentions endpoint supports powerful filtering with two modes:\n\nSimple Mode (Implicit AND)\n\nPut fields directly in filters. All conditions are ANDed together.\n\n{\n \"filters\": {\n \"source\": [\"twitter\", \"linkedin\"],\n \"sentiment\": [\"positive\"],\n \"minXFollowers\": 1000\n }\n}\n\n\n→ source IN (twitter, linkedin) AND sentiment = positive AND followers ≥ 1000\n\nExclusions\n\nPrefix any array field with ! to exclude values:\n\n{\n \"filters\": {\n \"source\": [\"twitter\"],\n \"!keyword\": [5, 6]\n }\n}\n\n\n→ source = twitter AND keyword NOT IN (5, 6)\n\nAdvanced Mode (AND/OR Groups)\n\nUse operator and groups for complex logic:\n\n{\n \"filters\": {\n \"operator\": \"AND\",\n \"groups\": [\n {\n \"operator\": \"OR\",\n \"conditions\": [\n { \"source\": [\"twitter\"] },\n { \"source\": [\"linkedin\"] }\n ]\n },\n {\n \"operator\": \"AND\",\n \"conditions\": [\n { \"sentiment\": [\"positive\"] },\n { \"!tag\": [\"spam\"] }\n ]\n }\n ]\n }\n}\n\n\n→ (source = twitter OR source = linkedin) AND (sentiment = positive AND tag ≠ spam)\n\nAvailable Filter Fields\nField\tType\tDescription\nsource\tstring[]\tPlatforms: twitter, reddit, github, linkedin, youtube, hackernews, devto, stackoverflow, bluesky, newsletter, podcast\nsentiment\tstring[]\tValues: positive, neutral, negative\nkeyword\tstring[]\tKeyword IDs (get from /keywords endpoint)\nlanguage\tstring[]\tISO 639-1 codes: en, es, fr, de, pt, it, nl, ja, ko, zh\ntag\tstring[]\tTag names\nbookmarked\tboolean\tFilter bookmarked (true) or non-bookmarked (false) posts\nengaged\tboolean\tFilter engaged (true) or non-engaged (false) posts\nminXFollowers\tnumber\tMinimum Twitter follower count\nmaxXFollowers\tnumber\tMaximum Twitter follower count\nstartDate\tstring\tISO 8601 format (e.g., \"2024-01-15T00:00:00Z\")\nendDate\tstring\tISO 8601 format\nUsing the Bundled Scripts\n\nThis skill includes helper scripts for common operations. Use them to quickly interact with the API:\n\nFetch Mentions\nnode scripts/fetch-mentions.js YOUR_API_KEY [limit] [includeAll]\n\nList Keywords\nnode scripts/list-keywords.js YOUR_API_KEY\n\nList Views\nnode scripts/list-views.js YOUR_API_KEY\n\nCustom Filter Query\nnode scripts/query-mentions.js YOUR_API_KEY '{\"source\": [\"twitter\"], \"sentiment\": [\"positive\"]}' [limit]\n\nAdvanced Query\nnode scripts/advanced-query.js YOUR_API_KEY [limit]\n\nBest Practices\nAlways ask for the API key before making requests\nUse views when possible to leverage pre-configured filters\nStart with simple filters and add complexity as needed\nCheck rate limits in response headers (X-RateLimit-*)\nUse pagination with cursor for large result sets\nDates must be ISO 8601 format (e.g., \"2024-01-15T00:00:00Z\")\nGet keyword IDs from /keywords endpoint before filtering by keyword\nUse exclusions (!) to filter out unwanted content\nCombine includeAll=false with relevance filtering for quality results\nCommon Use Cases\nFind positive Twitter mentions with high followers\n{\n \"limit\": 20,\n \"filters\": {\n \"source\": [\"twitter\"],\n \"sentiment\": [\"positive\"],\n \"minXFollowers\": 1000\n }\n}\n\nExclude spam and get Reddit + GitHub mentions\n{\n \"limit\": 50,\n \"filters\": {\n \"source\": [\"reddit\", \"github\"],\n \"!tag\": [\"spam\", \"irrelevant\"]\n }\n}\n\nComplex query: (Twitter OR LinkedIn) AND positive sentiment, last 7 days\n{\n \"limit\": 30,\n \"filters\": {\n \"operator\": \"AND\",\n \"groups\": [\n {\n \"operator\": \"OR\",\n \"conditions\": [\n { \"source\": [\"twitter\"] },\n { \"source\": [\"linkedin\"] }\n ]\n },\n {\n \"operator\": \"AND\",\n \"conditions\": [\n { \"sentiment\": [\"positive\"] },\n { \"startDate\": \"2024-01-20T00:00:00Z\" }\n ]\n }\n ]\n }\n}\n\nError Handling\nStatus\tError\tDescription\n401\tunauthorized\tMissing or invalid API key\n403\tforbidden\tValid key but no permission\n404\tnot_found\tResource (e.g., view ID) not found\n429\trate_limit_exceeded\tToo many requests\n400\tinvalid_request\tMalformed request body\n500\tinternal_error\tServer error, retry later\nStep-by-Step Workflow\n\nWhen a user asks to query Octolens data:\n\nAsk for API key if not already provided\nUnderstand the request: What are they looking for?\nDetermine filters needed: Source, sentiment, date range, etc.\nCheck if a view applies: List views first if user mentions saved filters\nBuild the query: Use simple mode first, advanced mode for complex logic\nExecute the request: Use bundled Node.js scripts or fetch API directly\nParse results: Extract key information (author, body, sentiment, source)\nHandle pagination: If more results needed, use cursor from response\nPresent findings: Summarize insights, highlight patterns\nExamples\nExample 1: Simple Query\n\nUser: \"Show me positive mentions from Twitter in the last 7 days\"\n\nAction (using bundled script):\n\nnode scripts/query-mentions.js YOUR_API_KEY '{\"source\": [\"twitter\"], \"sentiment\": [\"positive\"], \"startDate\": \"2024-01-20T00:00:00Z\"}'\n\n\nAlternative (using fetch API directly):\n\nconst response = await fetch('https://app.octolens.com/api/v1/mentions', {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${API_KEY}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n limit: 20,\n filters: {\n source: ['twitter'],\n sentiment: ['positive'],\n startDate: '2024-01-20T00:00:00Z',\n },\n }),\n});\nconst data = await response.json();\n\nExample 2: Advanced Query\n\nUser: \"Find mentions from Reddit or GitHub, exclude spam tag, with positive or neutral sentiment\"\n\nAction (using bundled script):\n\nnode scripts/query-mentions.js YOUR_API_KEY '{\"operator\": \"AND\", \"groups\": [{\"operator\": \"OR\", \"conditions\": [{\"source\": [\"reddit\"]}, {\"source\": [\"github\"]}]}, {\"operator\": \"OR\", \"conditions\": [{\"sentiment\": [\"positive\"]}, {\"sentiment\": [\"neutral\"]}]}, {\"operator\": \"AND\", \"conditions\": [{\"!tag\": [\"spam\"]}]}]}'\n\n\nAlternative (using fetch API directly):\n\nconst response = await fetch('https://app.octolens.com/api/v1/mentions', {\n method: 'POST',\n headers: {\n 'Authorization': `Bearer ${API_KEY}`,\n 'Content-Type': 'application/json',\n },\n body: JSON.stringify({\n limit: 30,\n filters: {\n operator: 'AND',\n groups: [\n {\n operator: 'OR',\n conditions: [\n { source: ['reddit'] },\n { source: ['github'] },\n ],\n },\n {\n operator: 'OR',\n conditions: [\n { sentiment: ['positive'] },\n { sentiment: ['neutral'] },\n ],\n },\n {\n operator: 'AND',\n conditions: [\n { '!tag': ['spam'] },\n ],\n },\n ],\n },\n }),\n});\nconst data = await response.json();\n\nExample 3: Get Keywords First\n\nUser: \"Show mentions for our main product keyword\"\n\nActions:\n\nFirst, list keywords:\nnode scripts/list-keywords.js YOUR_API_KEY\n\nThen query mentions with the keyword ID:\nnode scripts/query-mentions.js YOUR_API_KEY '{\"keyword\": [1]}'\n\nTips for Agents\nUse bundled scripts: The Node.js scripts handle JSON parsing automatically\nCache keywords: After fetching keywords once, remember them for the session\nExplain filters: When using complex filters, explain the logic to the user\nShow examples: When users are unsure, show example filter structures\nPaginate wisely: Ask if user wants more results before fetching next page\nSummarize insights: Don't just dump data, provide analysis (sentiment trends, top authors, platform distribution)" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/garrrikkotua/octolens", "publisherUrl": "https://clawhub.ai/garrrikkotua/octolens", "owner": "garrrikkotua", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/octolens", "downloadUrl": "https://openagent3.xyz/downloads/octolens", "agentUrl": "https://openagent3.xyz/skills/octolens/agent", "manifestUrl": "https://openagent3.xyz/skills/octolens/agent.json", "briefUrl": "https://openagent3.xyz/skills/octolens/agent.md" } }