ai-brand-monitor-mcp

Track brand mentions across Perplexity, ChatGPT, Claude & Gemini AI search inside any MCP agent. GEO scoring, share of voice, citations, competitors.

57
Stars
0
Forks
TypeScript
语言
2026/8/24
添加时间

⚠️ 第三方软件声明

本 Skill 为第三方开源软件,独立托管于 GitHub。SkillTip 仅为信息目录,不控制或维护底层仓库。所显示的安全检查为自动化且范围有限,安装前请自行审查源码。

阅读服务条款

安装

添加到你的 Claude Code skills 目录:

# Add to your Claude Code skills
git clone https://github.com/khadinakbarlabs/ai-brand-monitor-mcp

快速入门

使用 ai-brand-monitor-mcp 等 Skills 的指南。

安全报告

已验证

上次扫描:—

{
  "status": "PASSED",
  "issues": []
}

README.md

AI Brand Monitor MCP

The AI-Search brand-visibility MCP for AI agents — OAuth in 30 seconds, no API keys. Track how your brand appears in Perplexity, ChatGPT, Claude and Gemini search results directly inside Claude, Cursor, Codex, Windsurf, ChatGPT and any MCP-compatible AI client.

npm version MIT License MCP Apify Actor OAuth Works with Claude Works with Cursor Works with Windsurf Works with VS Code


What this is

A Model Context Protocol server that gives any MCP-compatible AI agent a single, reliable way to measure brand visibility across the four AI-search platforms:

  • 🔍 Perplexity — native Sonar search + citations
  • 💬 ChatGPT — gpt-4o-search-preview with live web search
  • 🧠 Claude — Claude Sonnet 4.5 with native Anthropic web_search tool
  • Gemini — Gemini 2.5 Flash with Google Search grounding

What each call returns

For every brand × query × platform combination:

  • 📊 Mention rate and position score (1 = AI leads with your brand, 10 = not mentioned)
  • 📎 Citation detection — does the AI link to your domain?
  • 😊 Sentiment — positive, neutral, or negative framing
  • 🥊 Competitor co-mentions — which rivals appear in the same response?
  • 🎯 GEO score (0–100) and plain-English recommendations in the run summary

Backed by a production Apify actor with OpenRouter-routed APIs, native web search on every platform, and a flat $0.08 per check.

Why use it inside an AI agent?

Traditional brand-monitoring tools live in a separate dashboard. This one lives inside the agent: Claude, Cursor, Codex or any other MCP client can plan a GEO strategy, audit a brand, diff two brands, or check weekly trends — and actually pull the data in the same turn.


Two ways to install

Option A: Cloud MCP (OAuth)Option B: Self-hosted (npm)
Install time~30 seconds2–3 minutes
What you needAn Apify account (OAuth popup signs you in)Node 18+ and an Apify API token
Runs whereApify CloudYour machine
Best forMost users — Claude, Cursor, Windsurf, VS Code, CodexSelf-hosted infra, air-gapped networks, advanced overrides
ConfigOne URLCommand + token env var

Not sure which one? Pick Option A. That's why it's first.

Client coverage at a glance (Option A)

ClientSurfaceInstall path
Claude.aiWeb · Desktop · Cowork · iOS · AndroidSettings → Connectors → Add custom connector
ChatGPTWeb · DesktopSettings → Connectors → Create (Pro/Team/Enterprise/Edu)
CursorDesktopOne-click deeplink or ~/.cursor/mcp.json
Claude CodeCLIclaude mcp add --transport http ...
VS CodeDesktop.vscode/mcp.json
WindsurfDesktop~/.codeium/windsurf/mcp_config.json
OpenAI Codex CLICLI~/.codex/config.toml

Option A — Cloud MCP (OAuth, recommended)

🔗 The one URL you need

https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor

Paste this into any MCP-compatible client. On first call, a browser tab opens, you sign into Apify, and the tools are live. No tokens. No npm install. One setting covers Claude web, Claude Desktop, Cowork, mobile apps, ChatGPT web, Cursor, Windsurf, VS Code, Claude Code, Codex CLI and any other Streamable-HTTP MCP client.

New to Apify? Accounts are free and include $5 of credits — enough for ~60 brand-query checks before you pay a cent.

Claude.ai (web, Cowork, mobile, Desktop — one setting for all)

  1. Open Claude → profile icon → Settings → Connectors.
  2. Scroll to the bottom and click "Add custom connector".
  3. Paste:
    https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor
    
  4. Click Connect. A browser tab opens for Apify OAuth. Approve it.
  5. You're done — the connector works across Claude web, Desktop, Cowork and mobile apps with a single setup.

Works on Free, Pro, Max, Team and Enterprise plans (Free is limited to 1 custom connector).

ChatGPT (web — Pro, Team, Enterprise, Edu)

  1. Open ChatGPT → Settings → Connectors (toggle Developer Mode in Advanced settings first if you don't see it).
  2. Click Create / Add custom connector.
  3. Fill in:
    • Name: AI Brand Monitor
    • Description: Track brand visibility across Perplexity, ChatGPT, Claude & Gemini.
    • MCP server URL: https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor
    • Authentication: OAuth (recommended) or Bearer with your Apify API token
  4. Save. First call opens the Apify OAuth popup.

Not available on the Free plan.

Claude Desktop

Open ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Add:

{
  "mcpServers": {
    "ai-brand-monitor": {
      "url": "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
    }
  }
}

Restart Claude Desktop. First call opens the OAuth popup.

Cursor

Either:

  • One-click: click the Cursor deeplink in the Apify Store listing, or

  • Manual: add to ~/.cursor/mcp.json:

    {
      "mcpServers": {
        "ai-brand-monitor": {
          "url": "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
        }
      }
    }
    

Claude Code

claude mcp add --transport http ai-brand-monitor \
  https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor

VS Code

Create .vscode/mcp.json in your workspace:

{
  "servers": {
    "ai-brand-monitor": {
      "type": "http",
      "url": "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
    }
  }
}

Windsurf

Edit ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "ai-brand-monitor": {
      "serverUrl": "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"
    }
  }
}

OpenAI Codex CLI

Edit ~/.codex/config.toml:

[mcp_servers.ai-brand-monitor]
url = "https://mcp.apify.com?tools=khadinakbar/ai-search-brand-monitor"

Option B — Self-hosted (npm)

Prerequisites

Install via npx (no global install)

// Claude Desktop or any JSON config
{
  "mcpServers": {
    "ai-brand-monitor": {
      "command": "npx",
      "args": ["-y", "ai-brand-monitor-mcp"],
      "env": {
        "APIFY_TOKEN": "apify_api_xxx"
      }
    }
  }
}

Optional environment variables

VariableDefaultPurpose
APIFY_TOKENRequired. Your Apify API token.
APIFY_ACTOR_IDkhadinakbar/ai-search-brand-monitorOverride to run against a forked actor.
DEFAULT_MAX_QUERIES3Used when the agent doesn't specify maxQueriesPerPlatform.
MAX_QUERIES_CEILING10Hard cap for maxQueriesPerPlatform. Protects credits.
APIFY_WAIT_SECS300How long to wait for an actor run before timing out.

Manual install (clone + build)

git clone https://github.com/khadinakbarlabs/ai-brand-monitor-mcp.git
cd ai-brand-monitor-mcp
npm install
npm run build
node dist/index.js

Tools

audit_brand_visibility

Run a comprehensive GEO audit using standard query templates — best for baselines, weekly monitoring, and before/after content measurements.

ParameterRequiredDescription
brandNameBrand to track (e.g. "Ahrefs")
brandDomainFor citation detection (e.g. "ahrefs.com")
brandAliasesAlternate names / acronyms
industryMakes template queries category-specific
competitorsUp to 10 rival brands for co-mention tracking
platformsSubset of perplexity, chatgpt, claude, gemini
queryTemplatesSubset of best_tools, alternatives, recommendations, reviews, comparisons
maxQueriesPerPlatform1–20, default 3

Example prompt (inside any MCP-enabled agent):

"Run a brand visibility audit for Ahrefs against Semrush and Moz in the SEO category. Pull 5 queries per platform."

check_brand_in_queries

Submit 1–10 custom questions across all four platforms — best when the user has specific prompts to test.

ParameterRequiredDescription
brandNameBrand to track
customQueries1–10 questions (strings)
brandDomainFor citation detection
brandAliasesAlternate names / acronyms
competitorsUp to 10 rival brands
platformsSubset of platforms

Example prompt:

"Ask Perplexity, ChatGPT and Claude 'What is the best tool for local-business SEO?' and tell me how often Ahrefs gets mentioned."


Output shape

Every tool call returns:

  • run — Apify run metadata (runId, datasetId, apifyRunUrl) so you can open the full dataset in Apify Console
  • count — number of per-check records
  • items[] — one record per brand × query × platform with mention context, sentiment, citations, competitor mentions
  • summary — aggregate geo_score (0–100), overall_mention_rate, platform_scores, and plain-English recommendations
  • truncated — boolean flag if the dataset was capped

Fields are flat and stable so agents can reliably extract values across runs.


Pricing

The Apify actor is pay-per-event:

  • actor-start: $0.00005 per run (per GB RAM)
  • brand-query-checked: $0.08 per brand × query × platform event

A typical audit (1 brand, 3 query templates × 2 queries each × 4 platforms = 24 checks) costs ~$1.92. All four AI platforms are included — no separate OpenAI / Anthropic / Perplexity / Google keys needed.

Your first $5 of Apify credits covers roughly 60 checks.


Privacy & security

  • The MCP server never sees AI platform API keys — all routing happens server-side on Apify.
  • Your Apify token stays in the MCP client config or Apify OAuth session; the server process never logs or persists it.
  • The per-check records never leave Apify's dataset storage unless the agent explicitly pushes them somewhere.

FAQ

Q: How is this different from just calling Perplexity / ChatGPT myself? A: This runs the same prompt across all four AI platforms with one call, scores brand mentions consistently, detects citations, and produces an aggregate GEO score. Running the same thing manually would mean four separate API signups, four billing setups, four different response parsers, and a score you have to compute yourself.

Q: Why does Claude have live web search? I thought Claude only used its training data. A: The underlying Apify actor enables Claude's native Anthropic web_search_20250305 server-side tool so Claude returns real 2026 citations, not stale training data. Same for Gemini (native Google Search grounding) and ChatGPT (native gpt-4o-search-preview).

Q: Can I monitor multiple brands? A: One brand per tool call today. Run the tool multiple times for multiple brands, or run it once per week for trend tracking.

Q: How often should I run this? A: Weekly is the sweet spot. Run after every major content push, product launch, or PR event to measure impact on AI search visibility.

Q: Is my Apify token stored on any server? A: Option A (Cloud MCP): your token sits in your own Apify session, managed by Apify's OAuth. Option B (self-hosted): the token is only in your local MCP client config.


Contributing

See CONTRIBUTING.md. PRs welcome for:

  • Additional MCP clients with install snippets
  • Output field projections (what to include / exclude in items[])
  • New query-template categories for the underlying Apify actor

License

MIT — see LICENSE.

Built by Khadin Akbar on top of the production ai-search-brand-monitor Apify actor.

常见问题

What is ai-brand-monitor-mcp?

ai-brand-monitor-mcp is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by khadinakbarlabs. Track brand mentions across Perplexity, ChatGPT, Claude & Gemini AI search inside any MCP agent. GEO scoring, share of voice, citations, competitors. It has 57 GitHub stars.

Is ai-brand-monitor-mcp safe to use?

ai-brand-monitor-mcp returned warnings in SkillsLLM's automated security scan. It has no critical vulnerabilities, but review the flagged issues in the Security Report section before adding it to your workflow.

How do I install ai-brand-monitor-mcp?

Clone the repository with "git clone https://github.com/khadinakbarlabs/ai-brand-monitor-mcp" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is ai-brand-monitor-mcp written in?

ai-brand-monitor-mcp is primarily written in TypeScript. It is open-source under khadinakbarlabs on GitHub, so you can review or fork the full source.

Are there alternatives to ai-brand-monitor-mcp?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh ai-brand-monitor-mcp against similar tools.

评论 (0)

暂无评论,成为第一个分享想法的人!

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI 智能体ai-agentsbrainstorming
查看详情

hermes-agent

by NousResearch

10

The agent that grows with you

234,43747,175Python
AI 智能体ai-agentsagent-orchestration
查看详情

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI 智能体claude-codeai-tools
查看详情

claude-code

by anthropics

Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.

120,03119,897Shell
AI 智能体
查看详情

开发者还喜欢

基于喜欢此 Skill 的开发者投票和收藏

ECC

by affaan-m

10

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

242,21936,702JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情
15

An agentic skills framework & software development methodology that works.

234,96620,863Shell
AI 智能体ai-agentsbrainstorming
查看详情

hermes-agent

by NousResearch

10

The agent that grows with you

234,43747,175Python
AI 智能体ai-agentsagent-orchestration
查看详情

n8n

by n8n-io

12

Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.

201,88160,308TypeScript
MCP 服务器apisai-tools
查看详情

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

185,94028,768JavaScript
AI 智能体ai-agentsanthropicclaude-code
查看详情

cc-switch

by farion1231

3

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io

128,8688,826Rust
AI 智能体claude-codeai-tools
查看详情