[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6CFQMN6XK3X0D0FFAJ4ZCC0":3,"skill-same:01M6CFQMN6XK3X0D0FFAJ4ZCC0":115},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":28,"publishedAt":48,"linkOnly":49,"markdownContent":50,"markdownBody":51,"frontMatter":52,"refName":57,"commitSha":58,"skillDirectory":59,"forksCount":60,"repositoryHtmlUrl":61,"repositoryHomepageUrl":6,"ownerHtmlUrl":62,"ownerBlogUrl":63,"ownerDescription":6,"updatedAt":64,"install":65,"resources":78},"01M6CFQMN6XK3X0D0FFAJ4ZCC0","octolens",null,"Query and analyze brand mentions from Octolens API. Use when the user wants to fetch mentions, track keywords, filter by source platforms (Twitter, Reddit, GitHub, LinkedIn, etc.), sentiment analysis, or analyze social media engagement. Supports complex filtering with AND\u002FOR logic, date ranges, follower counts, and bookmarks.","sundial-org\u002Fawesome-openclaw-skills","sundial-org","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F225963689?v=4","01M6CEAPGV2C2CVE8A0VCS0XZH","Sundial","01M6CEAPN7KM9TGZMBC07NDY3H",674,"MIT","https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002FSKILL.md",[18,23],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":26,"taxonomyTypeDesc":27},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[5,29,30,31,32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47],"twitter","engagement","use","filtering","fetch","read","bookmarks","social media","linkedin","github","node","brand","analyze","access","Media","api","analysis","sentiment","sentiment analysis","2026-11-10 10:12:30",false,"---\nname: octolens\ndescription: Query and analyze brand mentions from Octolens API. Use when the user wants to fetch mentions, track keywords, filter by source platforms (Twitter, Reddit, GitHub, LinkedIn, etc.), sentiment analysis, or analyze social media engagement. Supports complex filtering with AND\u002FOR logic, date ranges, follower counts, and bookmarks.\nlicense: MIT\nmetadata:\n  author: octolens\n  version: \"1.0\"\ncompatibility: Requires Node.js 18+ (for fetch API) and access to the internet\nallowed-tools: Node Read\n---\n\n# Octolens API Skill\n\n## When to use this skill\n\nUse this skill when the user needs to:\n- Fetch brand mentions from social media and other platforms\n- Filter mentions by source (Twitter, Reddit, GitHub, LinkedIn, YouTube, HackerNews, DevTO, StackOverflow, Bluesky, newsletters, podcasts)\n- Analyze sentiment (positive, neutral, negative)\n- Filter by author follower count or engagement\n- Search for specific keywords or tags\n- Query mentions by date range\n- List available keywords or saved views\n- Apply complex filtering logic with AND\u002FOR conditions\n\n## API 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\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n**Important**: Always ask the user for their API key before making any API calls. Store it in a variable for subsequent requests.\n\n## Base URL\n\nAll API endpoints use the base URL: `https:\u002F\u002Fapp.octolens.com\u002Fapi\u002Fv1`\n\n## Rate Limits\n\n- **Limit**: 500 requests per hour\n- **Check headers**: `X-RateLimit-*` headers indicate current usage\n\n## Available Endpoints\n\n### 1. POST \u002Fmentions\n\nFetch mentions matching keywords with optional filtering. Returns posts sorted by timestamp (newest first).\n\n**Key Parameters:**\n- `limit` (number, 1-100): Maximum results to return (default: 20)\n- `cursor` (string): Pagination cursor from previous response\n- `includeAll` (boolean): Include low-relevance posts (default: false)\n- `view` (number): View ID to use for filtering\n- `filters` (object): Filter criteria (see filtering section)\n\n**Example Response:**\n```json\n{\n  \"data\": [\n    {\n      \"id\": \"abc123\",\n      \"url\": \"https:\u002F\u002Ftwitter.com\u002Fuser\u002Fstatus\u002F123\",\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```\n\n### 2. GET \u002Fkeywords\n\nList all keywords configured for the organization.\n\n**Example Response:**\n```json\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```\n\n### 3. GET \u002Fviews\n\nList all saved views (pre-configured filters).\n\n**Example Response:**\n```json\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```\n\n## Filtering Mentions\n\nThe `\u002Fmentions` endpoint supports powerful filtering with two modes:\n\n### Simple Mode (Implicit AND)\n\nPut fields directly in filters. All conditions are ANDed together.\n\n```json\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`\n\n### Exclusions\n\nPrefix any array field with ! to exclude values:\n\n```json\n{\n  \"filters\": {\n    \"source\": [\"twitter\"],\n    \"!keyword\": [5, 6]\n  }\n}\n```\n→ `source = twitter AND keyword NOT IN (5, 6)`\n\n### Advanced Mode (AND\u002FOR Groups)\n\nUse `operator` and `groups` for complex logic:\n\n```json\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)`\n\n### Available Filter Fields\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `source` | string[] | Platforms: twitter, reddit, github, linkedin, youtube, hackernews, devto, stackoverflow, bluesky, newsletter, podcast |\n| `sentiment` | string[] | Values: positive, neutral, negative |\n| `keyword` | string[] | Keyword IDs (get from \u002Fkeywords endpoint) |\n| `language` | string[] | ISO 639-1 codes: en, es, fr, de, pt, it, nl, ja, ko, zh |\n| `tag` | string[] | Tag names |\n| `bookmarked` | boolean | Filter bookmarked (true) or non-bookmarked (false) posts |\n| `engaged` | boolean | Filter engaged (true) or non-engaged (false) posts |\n| `minXFollowers` | number | Minimum Twitter follower count |\n| `maxXFollowers` | number | Maximum Twitter follower count |\n| `startDate` | string | ISO 8601 format (e.g., \"2024-01-15T00:00:00Z\") |\n| `endDate` | string | ISO 8601 format |\n\n## Using the Bundled Scripts\n\nThis skill includes helper scripts for common operations. Use them to quickly interact with the API:\n\n### Fetch Mentions\n```bash\nnode scripts\u002Ffetch-mentions.js YOUR_API_KEY [limit] [includeAll]\n```\n\n### List Keywords\n```bash\nnode scripts\u002Flist-keywords.js YOUR_API_KEY\n```\n\n### List Views\n```bash\nnode scripts\u002Flist-views.js YOUR_API_KEY\n```\n\n### Custom Filter Query\n```bash\nnode scripts\u002Fquery-mentions.js YOUR_API_KEY '{\"source\": [\"twitter\"], \"sentiment\": [\"positive\"]}' [limit]\n```\n\n### Advanced Query\n```bash\nnode scripts\u002Fadvanced-query.js YOUR_API_KEY [limit]\n```\n\n## Best Practices\n\n1. **Always ask for the API key** before making requests\n2. **Use views** when possible to leverage pre-configured filters\n3. **Start with simple filters** and add complexity as needed\n4. **Check rate limits** in response headers (`X-RateLimit-*`)\n5. **Use pagination** with cursor for large result sets\n6. **Dates must be ISO 8601** format (e.g., \"2024-01-15T00:00:00Z\")\n7. **Get keyword IDs** from `\u002Fkeywords` endpoint before filtering by keyword\n8. **Use exclusions** (!) to filter out unwanted content\n9. **Combine includeAll=false** with relevance filtering for quality results\n\n## Common Use Cases\n\n### Find positive Twitter mentions with high followers\n```json\n{\n  \"limit\": 20,\n  \"filters\": {\n    \"source\": [\"twitter\"],\n    \"sentiment\": [\"positive\"],\n    \"minXFollowers\": 1000\n  }\n}\n```\n\n### Exclude spam and get Reddit + GitHub mentions\n```json\n{\n  \"limit\": 50,\n  \"filters\": {\n    \"source\": [\"reddit\", \"github\"],\n    \"!tag\": [\"spam\", \"irrelevant\"]\n  }\n}\n```\n\n### Complex query: (Twitter OR LinkedIn) AND positive sentiment, last 7 days\n```json\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```\n\n## Error Handling\n\n| Status | Error | Description |\n|--------|-------|-------------|\n| 401 | unauthorized | Missing or invalid API key |\n| 403 | forbidden | Valid key but no permission |\n| 404 | not_found | Resource (e.g., view ID) not found |\n| 429 | rate_limit_exceeded | Too many requests |\n| 400 | invalid_request | Malformed request body |\n| 500 | internal_error | Server error, retry later |\n\n## Step-by-Step Workflow\n\nWhen a user asks to query Octolens data:\n\n1. **Ask for API key** if not already provided\n2. **Understand the request**: What are they looking for?\n3. **Determine filters needed**: Source, sentiment, date range, etc.\n4. **Check if a view applies**: List views first if user mentions saved filters\n5. **Build the query**: Use simple mode first, advanced mode for complex logic\n6. **Execute the request**: Use bundled Node.js scripts or fetch API directly\n7. **Parse results**: Extract key information (author, body, sentiment, source)\n8. **Handle pagination**: If more results needed, use cursor from response\n9. **Present findings**: Summarize insights, highlight patterns\n\n## Examples\n\n### Example 1: Simple Query\n**User**: \"Show me positive mentions from Twitter in the last 7 days\"\n\n**Action** (using bundled script):\n```bash\nnode scripts\u002Fquery-mentions.js YOUR_API_KEY '{\"source\": [\"twitter\"], \"sentiment\": [\"positive\"], \"startDate\": \"2024-01-20T00:00:00Z\"}'\n```\n\n**Alternative** (using fetch API directly):\n```javascript\nconst response = await fetch('https:\u002F\u002Fapp.octolens.com\u002Fapi\u002Fv1\u002Fmentions', {\n  method: 'POST',\n  headers: {\n    'Authorization': `Bearer ${API_KEY}`,\n    'Content-Type': 'application\u002Fjson',\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```\n\n### Example 2: Advanced Query\n**User**: \"Find mentions from Reddit or GitHub, exclude spam tag, with positive or neutral sentiment\"\n\n**Action** (using bundled script):\n```bash\nnode scripts\u002Fquery-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\n**Alternative** (using fetch API directly):\n```javascript\nconst response = await fetch('https:\u002F\u002Fapp.octolens.com\u002Fapi\u002Fv1\u002Fmentions', {\n  method: 'POST',\n  headers: {\n    'Authorization': `Bearer ${API_KEY}`,\n    'Content-Type': 'application\u002Fjson',\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```\n\n### Example 3: Get Keywords First\n**User**: \"Show mentions for our main product keyword\"\n\n**Actions**:\n1. First, list keywords:\n```bash\nnode scripts\u002Flist-keywords.js YOUR_API_KEY\n```\n\n2. Then query mentions with the keyword ID:\n```bash\nnode scripts\u002Fquery-mentions.js YOUR_API_KEY '{\"keyword\": [1]}'\n```\n\n## Tips for Agents\n\n- **Use bundled scripts**: The Node.js scripts handle JSON parsing automatically\n- **Cache keywords**: After fetching keywords once, remember them for the session\n- **Explain filters**: When using complex filters, explain the logic to the user\n- **Show examples**: When users are unsure, show example filter structures\n- **Paginate wisely**: Ask if user wants more results before fetching next page\n- **Summarize insights**: Don't just dump data, provide analysis (sentiment trends, top authors, platform distribution)\n","# Octolens API Skill\n\n## When to use this skill\n\nUse this skill when the user needs to:\n- Fetch brand mentions from social media and other platforms\n- Filter mentions by source (Twitter, Reddit, GitHub, LinkedIn, YouTube, HackerNews, DevTO, StackOverflow, Bluesky, newsletters, podcasts)\n- Analyze sentiment (positive, neutral, negative)\n- Filter by author follower count or engagement\n- Search for specific keywords or tags\n- Query mentions by date range\n- List available keywords or saved views\n- Apply complex filtering logic with AND\u002FOR conditions\n\n## API 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\n```\nAuthorization: Bearer YOUR_API_KEY\n```\n\n**Important**: Always ask the user for their API key before making any API calls. Store it in a variable for subsequent requests.\n\n## Base URL\n\nAll API endpoints use the base URL: `https:\u002F\u002Fapp.octolens.com\u002Fapi\u002Fv1`\n\n## Rate Limits\n\n- **Limit**: 500 requests per hour\n- **Check headers**: `X-RateLimit-*` headers indicate current usage\n\n## Available Endpoints\n\n### 1. POST \u002Fmentions\n\nFetch mentions matching keywords with optional filtering. Returns posts sorted by timestamp (newest first).\n\n**Key Parameters:**\n- `limit` (number, 1-100): Maximum results to return (default: 20)\n- `cursor` (string): Pagination cursor from previous response\n- `includeAll` (boolean): Include low-relevance posts (default: false)\n- `view` (number): View ID to use for filtering\n- `filters` (object): Filter criteria (see filtering section)\n\n**Example Response:**\n```json\n{\n  \"data\": [\n    {\n      \"id\": \"abc123\",\n      \"url\": \"https:\u002F\u002Ftwitter.com\u002Fuser\u002Fstatus\u002F123\",\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```\n\n### 2. GET \u002Fkeywords\n\nList all keywords configured for the organization.\n\n**Example Response:**\n```json\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```\n\n### 3. GET \u002Fviews\n\nList all saved views (pre-configured filters).\n\n**Example Response:**\n```json\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```\n\n## Filtering Mentions\n\nThe `\u002Fmentions` endpoint supports powerful filtering with two modes:\n\n### Simple Mode (Implicit AND)\n\nPut fields directly in filters. All conditions are ANDed together.\n\n```json\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`\n\n### Exclusions\n\nPrefix any array field with ! to exclude values:\n\n```json\n{\n  \"filters\": {\n    \"source\": [\"twitter\"],\n    \"!keyword\": [5, 6]\n  }\n}\n```\n→ `source = twitter AND keyword NOT IN (5, 6)`\n\n### Advanced Mode (AND\u002FOR Groups)\n\nUse `operator` and `groups` for complex logic:\n\n```json\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)`\n\n### Available Filter Fields\n\n| Field | Type | Description |\n|-------|------|-------------|\n| `source` | string[] | Platforms: twitter, reddit, github, linkedin, youtube, hackernews, devto, stackoverflow, bluesky, newsletter, podcast |\n| `sentiment` | string[] | Values: positive, neutral, negative |\n| `keyword` | string[] | Keyword IDs (get from \u002Fkeywords endpoint) |\n| `language` | string[] | ISO 639-1 codes: en, es, fr, de, pt, it, nl, ja, ko, zh |\n| `tag` | string[] | Tag names |\n| `bookmarked` | boolean | Filter bookmarked (true) or non-bookmarked (false) posts |\n| `engaged` | boolean | Filter engaged (true) or non-engaged (false) posts |\n| `minXFollowers` | number | Minimum Twitter follower count |\n| `maxXFollowers` | number | Maximum Twitter follower count |\n| `startDate` | string | ISO 8601 format (e.g., \"2024-01-15T00:00:00Z\") |\n| `endDate` | string | ISO 8601 format |\n\n## Using the Bundled Scripts\n\nThis skill includes helper scripts for common operations. Use them to quickly interact with the API:\n\n### Fetch Mentions\n```bash\nnode scripts\u002Ffetch-mentions.js YOUR_API_KEY [limit] [includeAll]\n```\n\n### List Keywords\n```bash\nnode scripts\u002Flist-keywords.js YOUR_API_KEY\n```\n\n### List Views\n```bash\nnode scripts\u002Flist-views.js YOUR_API_KEY\n```\n\n### Custom Filter Query\n```bash\nnode scripts\u002Fquery-mentions.js YOUR_API_KEY '{\"source\": [\"twitter\"], \"sentiment\": [\"positive\"]}' [limit]\n```\n\n### Advanced Query\n```bash\nnode scripts\u002Fadvanced-query.js YOUR_API_KEY [limit]\n```\n\n## Best Practices\n\n1. **Always ask for the API key** before making requests\n2. **Use views** when possible to leverage pre-configured filters\n3. **Start with simple filters** and add complexity as needed\n4. **Check rate limits** in response headers (`X-RateLimit-*`)\n5. **Use pagination** with cursor for large result sets\n6. **Dates must be ISO 8601** format (e.g., \"2024-01-15T00:00:00Z\")\n7. **Get keyword IDs** from `\u002Fkeywords` endpoint before filtering by keyword\n8. **Use exclusions** (!) to filter out unwanted content\n9. **Combine includeAll=false** with relevance filtering for quality results\n\n## Common Use Cases\n\n### Find positive Twitter mentions with high followers\n```json\n{\n  \"limit\": 20,\n  \"filters\": {\n    \"source\": [\"twitter\"],\n    \"sentiment\": [\"positive\"],\n    \"minXFollowers\": 1000\n  }\n}\n```\n\n### Exclude spam and get Reddit + GitHub mentions\n```json\n{\n  \"limit\": 50,\n  \"filters\": {\n    \"source\": [\"reddit\", \"github\"],\n    \"!tag\": [\"spam\", \"irrelevant\"]\n  }\n}\n```\n\n### Complex query: (Twitter OR LinkedIn) AND positive sentiment, last 7 days\n```json\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```\n\n## Error Handling\n\n| Status | Error | Description |\n|--------|-------|-------------|\n| 401 | unauthorized | Missing or invalid API key |\n| 403 | forbidden | Valid key but no permission |\n| 404 | not_found | Resource (e.g., view ID) not found |\n| 429 | rate_limit_exceeded | Too many requests |\n| 400 | invalid_request | Malformed request body |\n| 500 | internal_error | Server error, retry later |\n\n## Step-by-Step Workflow\n\nWhen a user asks to query Octolens data:\n\n1. **Ask for API key** if not already provided\n2. **Understand the request**: What are they looking for?\n3. **Determine filters needed**: Source, sentiment, date range, etc.\n4. **Check if a view applies**: List views first if user mentions saved filters\n5. **Build the query**: Use simple mode first, advanced mode for complex logic\n6. **Execute the request**: Use bundled Node.js scripts or fetch API directly\n7. **Parse results**: Extract key information (author, body, sentiment, source)\n8. **Handle pagination**: If more results needed, use cursor from response\n9. **Present findings**: Summarize insights, highlight patterns\n\n## Examples\n\n### Example 1: Simple Query\n**User**: \"Show me positive mentions from Twitter in the last 7 days\"\n\n**Action** (using bundled script):\n```bash\nnode scripts\u002Fquery-mentions.js YOUR_API_KEY '{\"source\": [\"twitter\"], \"sentiment\": [\"positive\"], \"startDate\": \"2024-01-20T00:00:00Z\"}'\n```\n\n**Alternative** (using fetch API directly):\n```javascript\nconst response = await fetch('https:\u002F\u002Fapp.octolens.com\u002Fapi\u002Fv1\u002Fmentions', {\n  method: 'POST',\n  headers: {\n    'Authorization': `Bearer ${API_KEY}`,\n    'Content-Type': 'application\u002Fjson',\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```\n\n### Example 2: Advanced Query\n**User**: \"Find mentions from Reddit or GitHub, exclude spam tag, with positive or neutral sentiment\"\n\n**Action** (using bundled script):\n```bash\nnode scripts\u002Fquery-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\n**Alternative** (using fetch API directly):\n```javascript\nconst response = await fetch('https:\u002F\u002Fapp.octolens.com\u002Fapi\u002Fv1\u002Fmentions', {\n  method: 'POST',\n  headers: {\n    'Authorization': `Bearer ${API_KEY}`,\n    'Content-Type': 'application\u002Fjson',\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```\n\n### Example 3: Get Keywords First\n**User**: \"Show mentions for our main product keyword\"\n\n**Actions**:\n1. First, list keywords:\n```bash\nnode scripts\u002Flist-keywords.js YOUR_API_KEY\n```\n\n2. Then query mentions with the keyword ID:\n```bash\nnode scripts\u002Fquery-mentions.js YOUR_API_KEY '{\"keyword\": [1]}'\n```\n\n## Tips for Agents\n\n- **Use bundled scripts**: The Node.js scripts handle JSON parsing automatically\n- **Cache keywords**: After fetching keywords once, remember them for the session\n- **Explain filters**: When using complex filters, explain the logic to the user\n- **Show examples**: When users are unsure, show example filter structures\n- **Paginate wisely**: Ask if user wants more results before fetching next page\n- **Summarize insights**: Don't just dump data, provide analysis (sentiment trends, top authors, platform distribution)\n",{"name":5,"license":15,"metadata":53,"description":7,"allowed-tools":55,"compatibility":56},{"author":5,"version":54},"1.0","Node Read","Requires Node.js 18+ (for fetch API) and access to the internet","main","b80cde2ef85241dd4fd54a1b934f5e22835f78ba","skills\u002Foctolens",102,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills","https:\u002F\u002Fgithub.com\u002Fsundial-org","https:\u002F\u002Fwww.sundialhub.com","2026-03-07 14:57:19",{"source":8,"skillName":5,"commands":66,"prompt":76,"zipAvailable":77},[67,70,73],{"tool":68,"command":69},"npx","npx skills add sundial-org\u002Fawesome-openclaw-skills --skill octolens",{"tool":71,"command":72},"bunx","bunx skills add sundial-org\u002Fawesome-openclaw-skills --skill octolens",{"tool":74,"command":75},"pnpm","pnpm dlx skills add sundial-org\u002Fawesome-openclaw-skills --skill octolens","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002FSKILL.md",true,[79,85,89,95,99,103,107,111],{"path":80,"resourceType":81,"resourceTypeDesc":82,"sizeBytes":83,"sourceHtmlUrl":84},"references\u002FEXAMPLES.md","REFERENCE","参考文档",13595,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002Freferences\u002FEXAMPLES.md",{"path":86,"resourceType":81,"resourceTypeDesc":82,"sizeBytes":87,"sourceHtmlUrl":88},"references\u002FFILTERS.md",12904,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002Freferences\u002FFILTERS.md",{"path":90,"resourceType":91,"resourceTypeDesc":92,"sizeBytes":93,"sourceHtmlUrl":94},"scripts\u002Fadvanced-query.js","SCRIPT","脚本",1816,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002Fscripts\u002Fadvanced-query.js",{"path":96,"resourceType":91,"resourceTypeDesc":92,"sizeBytes":97,"sourceHtmlUrl":98},"scripts\u002Ffetch-mentions.js",1517,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002Fscripts\u002Ffetch-mentions.js",{"path":100,"resourceType":91,"resourceTypeDesc":92,"sizeBytes":101,"sourceHtmlUrl":102},"scripts\u002Flist-keywords.js",1137,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002Fscripts\u002Flist-keywords.js",{"path":104,"resourceType":91,"resourceTypeDesc":92,"sizeBytes":105,"sourceHtmlUrl":106},"scripts\u002Flist-views.js",1125,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002Fscripts\u002Flist-views.js",{"path":108,"resourceType":91,"resourceTypeDesc":92,"sizeBytes":109,"sourceHtmlUrl":110},"scripts\u002Fquery-mentions.js",2049,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002Fscripts\u002Fquery-mentions.js",{"path":112,"resourceType":91,"resourceTypeDesc":92,"sizeBytes":113,"sourceHtmlUrl":114},"scripts\u002FREADME.md",6479,"https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Foctolens\u002Fscripts\u002FREADME.md",[116,125,154,175,197,221],{"skillNo":117,"name":118,"nameZh":6,"description":119,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":120,"categories":121,"keywords":122,"publishedAt":48},"01M6CGQVNAEMJTA5P9GZVYNCVG","x-trends","Fetches current top trending topics on X (Twitter) for any country using public aggregators.","https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fx-trends\u002FSKILL.md",[],[123,124,29],"x trends","public",{"skillNo":126,"name":127,"nameZh":6,"description":128,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":129,"categories":130,"keywords":134,"publishedAt":48},"01M6CGKR0DGWD64YAYJ4WH32C0","vercel-react-best-practices","React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React\u002FNext.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.","https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fvercel-react-best-practices\u002FSKILL.md",[131],{"categoryNo":132,"categoryName":133,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000009","前端开发",[135,136,137,138,139,140,141,142,143,144,145,146,147,148,149,150,151,152,153],"vercel react best practices","react","best practices","react best practices","vercel","tasks","performance optimization","js","refactoring","Next.js","data","Optimization","engineering","code","guidelines","react components","components","performance","writing",{"skillNo":155,"name":156,"nameZh":6,"description":157,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":158,"categories":159,"keywords":160,"publishedAt":48},"01M6CGGNS5N14QNV719AK25G94","topydo","Manage todo.txt tasks using topydo CLI. Add, list, complete, prioritize, tag, and organize tasks with dependencies, due dates, recurrence, and projects. Use for any task management, todo lists, or when the user mentions tasks, todos, or todo.txt. Requires Python 3 and pip. Works on macOS, Linux, and Windows.","https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftopydo\u002FSKILL.md",[],[156,140,161,162,163,164,165,166,38,167,168,169,170,171,172,173,31,174],"prioritize","projects","windows","task management","list","linux","python","cli","macos","management","todo","task","manage","user",{"skillNo":176,"name":177,"nameZh":6,"description":178,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":179,"categories":180,"keywords":181,"publishedAt":48},"01M6CFRM7YJ2Q07KTV6CH0PMCK","openclaw-feeds","RSS news aggregator. Fetches headlines from curated feeds across three categories: news, games, and finance. Use when the user asks about current news, headlines, what's happening, what's going on, or says \"what's up in news\", \"what's up in finance\", \"what's up in games\", or the German equivalents \"was geht mit nachrichten\", \"was geht mit money\", \"was geht mit gaming\". Also activates for requests like \"give me a news rundown\", \"latest headlines\", \"market news\", \"gaming news\", \"tech news\", \"finance roundup\", or \"briefing\". Returns structured JSON from public RSS feeds — no API keys, no web search needed.","https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fopenclaw-feeds\u002FSKILL.md",[],[182,183,184,185,186,187,188,31,189,190,191,192,42,193,44,194,195,196,167,33],"openclaw","feeds","openclaw feeds","install","german","Market","up","json","python3","rss","web search","Bash","roundup","search","web",{"skillNo":198,"name":199,"nameZh":6,"description":200,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":201,"categories":202,"keywords":204,"publishedAt":48},"01M6CFEG2QX0E4Y9D5VFXWGQ2X","lmstudio-subagents","Reduces token usage from paid providers by offloading work to local LM Studio models. Use when: (1) Cutting costs—use local models for summarization, extraction, classification, rewriting, first-pass review, brainstorming when quality suffices, (2) Avoiding paid API calls for high-volume or repetitive tasks, (3) No extra model configuration—JIT loading and REST API work with existing LM Studio setup, (4) Local-only or privacy-sensitive work. Requires LM Studio 0.4+ with server (default :1234). No CLI required.","https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Flmstudio-subagents\u002FSKILL.md",[203],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},[205,206,207,208,140,209,168,210,211,212,213,214,31,215,216,217,218,44,219,220],"lmstudio subagents","subagents","privacy","server","brainstorming","review","Local Models","default","models","only","work","quality","model","classification","first","REST",{"skillNo":222,"name":223,"nameZh":6,"description":224,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":225,"categories":226,"keywords":233,"publishedAt":48},"01M6CFC8KPHE8AVXX0DCMV8G7T","kubectl-skill","Execute and manage Kubernetes clusters via kubectl commands. Query resources, deploy applications, debug containers, manage configurations, and monitor cluster health. Use when working with Kubernetes clusters, containers, deployments, or pod diagnostics.","https:\u002F\u002Fgithub.com\u002Fsundial-org\u002Fawesome-openclaw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fkubectl-skill\u002FSKILL.md",[227,230],{"categoryNo":228,"categoryName":229,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000011","运维与部署",{"categoryNo":231,"categoryName":232,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",[234,235,236,173,237,238,31,239,240,241,242,243,244,245,163,166,246,247,248,249],"kubectl skill","kubectl","health","deployments","container","execute","applications","deployment","monitor","diagnostics","debug","deploy","kubernetes","docker","containers","gmail"]