Agent skill · data analytics · sundial-org
octolens
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/OR logic, date ranges, follower counts, and bookmarks.
Why this skill is useful
Provides specific API commands and filtering logic for analyzing brand mentions that the AI wouldn't reliably generate on its own.
What it needs
Requires node installed locally. Requires octolens account access. About 6k tokens when loaded. Last updated 2026-03-07. 639 stars on the source repository.
What this skill does
Octolens API Skill When to use this skill Use this skill when the user needs to: Fetch brand mentions from social media and other platforms Filter mentions by source (Twitter, Reddit, GitHub, LinkedIn, YouTube, HackerNews, DevTO, StackOverflow, Bluesky, newsletters, podcasts) Analyze sentiment (positive, neutral, negative) Filter by author follower count or engagement Search for specific keywords or tags Query mentions by date range List available keywords or saved views Apply complex filtering logic with AND/OR conditions API Authentication The Octolens API requires a Bearer token for authentication. The user should provide their API key, which you'll use in the Authorization header: Important: Always ask the user for their API key before making any API calls. Store it in a variable for subsequent requests. Base URL All API endpoints use the base URL: https://app.octolens.com/api/v1 Rate Limits Limit: 500 requests per hour Check headers: X-RateLimit- headers indicate current usage Available Endpoints 1. POST /mentions Fetch mentions matching keywords with optional filtering. Returns posts sorted by timestamp (newest first). Key Parameters: limit (number, 1-100): Maximum results to return (default: 20) cursor (string): Pagination cursor from previous response includeAll (boolean): Include low-relevance posts (default: false) view (number): View ID to use for filtering filters (object): Filter criteria (see filtering section) Example Response: 2. GET /keywords List all keywords configured for the organization. Example Response: 3. GET /views List all saved views (pre-configured filters). Example Response: Filtering Mentions The /mentions endpoint supports powerful filtering with two modes: Simple Mode (Implicit AND) Put fields directly in filters. All conditions are ANDed together. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills sundial-org/octolens