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"

This uses the REST API tools (not MCP) since scheduled jobs run headlessly.

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 for both paths
└── 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