Skip to main content
The Octolens Agent Skill is a drop-in package of expertise that teaches AI coding agents how to work with Octolens correctly — which tools to call, how to filter mentions, how to set up keywords and alerts, and the gotchas to avoid. Once installed, your agent reaches for it automatically whenever a task involves Octolens. It’s an open Agent Skill — one SKILL.md plus a reference doc — so it works in any compatible agent (Claude Code, Cursor, and more).
The skill is the knowledge layer; the MCP server and REST API are the connection. The skill tells your agent to prefer MCP for interactive work and the REST API for scripting and exports — and how to use each.

​
Install

npx skills add octolens/skill
That’s it — the skill installs into your agent’s skills directory and activates on its own when you ask anything Octolens-related. You can also browse it on skills.sh or view the source on GitHub.

​
What it does

With the skill installed, you can ask your agent things like:
  • “Pull the last week of negative Reddit mentions and summarize the top complaints.”
  • “Add ‘next.js deployment’ as a keyword and route buy-intent mentions to my #leads Slack channel.”
  • “Export all competitor mentions from this quarter to CSV.”
  • “Chart share of voice for my brand vs. its two top competitors.”
The agent knows to:
  • Choose the right surface — MCP for interactive questions and setup, REST v2 for scripts, CI, and bulk export.
  • Filter mentions correctly — the simple and advanced filter grammar, valid platforms/sentiment/tag values, and ID-based keyword filtering.
  • Manage your workspace — create and update keywords and feeds, wire up Slack / email / webhook destinations, and run analytics.
  • Avoid common mistakes — stale v1 filter fields, timestamp formats, scope errors, and more.

​
How it works

Agent Skills use progressive disclosure: the agent loads only a short description at startup, then pulls in the full instructions when a task matches. Your context window stays lean until Octolens is actually relevant.

MCP Server

The preferred connection for interactive AI workflows. OAuth sign-in, no API key.

REST API

For scripts, backend jobs, and bulk export. Bearer auth with an API key.

​
Requirements

  • An Octolens plan with API access (Pro, Scale, or Enterprise).
  • An MCP-capable agent (for the MCP path) or an API key from Settings → API (for the REST path).