Octolens Plugin

Social listening for the Vellum assistant. Monitor brand mentions, competitor activity, and industry conversations across 13+ platforms using Octolens.

What it does

Tracks mentions of your brand, competitors, and industry terms across Reddit, X, GitHub, Hacker News, LinkedIn, YouTube, Bluesky, TikTok, podcasts, newsletters, and more. Each mention includes AI-assigned sentiment, relevance score, and topical tags.

Tools

Four REST API tools for programmatic access, scheduled jobs, and structured queries:

Tool	Purpose
octolens_mentions	List, get, and update mentions with filters
octolens_analytics	Sentiment distribution, volume over time, per-keyword and source breakdowns
octolens_keywords	Create, update, pause, delete keywords; list tags and suggestions
octolens_feeds	Create and manage saved filter views and notification destinations

How to use

Install

assistant plugins install octolens

Connect Octolens

1. Go to Octolens > Settings > API and create a key (read, write, or admin scope).
2. Tell your assistant: "set my Octolens API key to "
3. Done. Tools will work immediately.

Example prompts

Once connected, try these:

• "Show me all mentions of my brand from the last 7 days"
• "What's the sentiment breakdown across my competitors this month?"
• "Find negative Reddit mentions about [competitor] from this week"
• "Create a feed for buy-intent mentions and send it to my #leads Slack channel daily"
• "Plot mention volume by day, split by sentiment"
• "Add 'open source AI assistant' as a new industry-term keyword"
• "Give me a morning digest of yesterday's mentions, grouped by platform"
• "Which keywords have the most negative sentiment this week?"

Setting up keyword alerts to Slack

1. Create a keyword: "track 'my brand' as own_brand"
2. Create a feed: "create a feed called 'Negative brand mentions' with sentiment negative"
3. Find your Slack channel: "search Slack for #marketing"
4. Wire it up: "send the negative brand mentions feed to #marketing daily"

Scheduled mention digests

Ask your assistant to create a scheduled job that calls octolens_mentions daily:

• "Every morning at 8am, pull yesterday's mentions and summarize the top 5"

Plugin structure

octolens/
├── package.json
├── config.json
├── hooks/
│   └── init.ts              — setup checks and guidance on load
├── tools/
│   ├── octolens_mentions.ts — list, get, update mentions
│   ├── octolens_analytics.ts — sentiment, volume, per-keyword, source
│   ├── octolens_keywords.ts — CRUD keywords, tags, suggestions
│   └── octolens_feeds.ts    — CRUD feeds, destinations, Slack search
├── skills/
│   └── social-listening/
│       └── SKILL.md         — workflow guide
└── src/
    └── api.ts               — shared REST client (auth, rate limits, errors)

API reference

• Base URL: https://app.octolens.com/api/v2
• Auth: Bearer token in Authorization header
• Rate limit: 500 requests/hour per organization
• Error envelope: { error: { code, message, status, details } }

Full docs: octolens.com/docs

License

MIT