AI Reputation Agent

September 8, 2026 · View on GitHub

An AI agent for brand reputation — news monitoring, social sentiment tracking, review mining, and PR response drafting — backed by real news, social, and review-data APIs.

Part of Agency Agents OS, an open ecosystem of specialized AI agents for real business work.

Agency Agents OS — the central catalog this repo is part of.
ai-social-agent — shares this repo's sentiment/listening data sources.
ai-ecommerce-agent — shares this repo's Amazon/Google review-data needs.
ai-competitor-intelligence-agent — feeds this repo's findings into cross-cutting competitive audits.
MuAPI MCP docs — connect this repo's SKILL.md files via MCP.
MuAPI access keys — create the API key this agent needs.

What this covers

This repo is the umbrella for anything an agency or in-house team would call "the AI reputation agent": watching news, social, and review channels for brand mentions, surfacing sentiment shifts and reputation risks, and drafting (never publishing) the response when something needs one.

Sub-agents

Agent	Does	Status
News Monitoring	Tracks news and press mentions of a brand and flags anything requiring a response	Coming Soon
Social Sentiment	Tracks sentiment trends about a brand across social platforms over time	Coming Soon
Review Mining	Aggregates and summarizes themes from reviews (Amazon, Google, app stores) to flag reputation risks	Blueprint (Google reviews only)
PR & Communications	Drafts response statements and talking points for a flagged reputation event, for human review before publishing	Coming Soon

Required Muapi APIs

reputation.news_search — search and monitor news/press coverage for brand mentions.
social.sentiment_analysis — sentiment scoring and trend tracking across social platforms.
reputation.review_search — search and aggregate reviews across review platforms.

See each sub-agent's SKILL.md for the specific capabilities it uses.

Setup

Create a Muapi account and API key at muapi.ai.
Review the Muapi API quickstart and OpenAPI schema for the reputation, social, and review endpoints.
Load the SKILL.md for the sub-agent you need into your agent runtime (hosted agent, MCP client, or custom LLM app), or follow it manually.

Using with an AI agent

Every sub-agent's SKILL.md is model- and runtime-agnostic — it's plain Markdown, so it works with any LLM agent, not just Claude. Two integration paths:

As an MCP connection (the agent gets live Muapi tools):

Muapi runs an MCP server at https://api.muapi.ai/mcp that any MCP-compatible client can connect to — Cursor, Windsurf, Claude, or your own custom agent.

Cursor / Windsurf / other clients with a header field: connect to https://api.muapi.ai/mcp with an Authorization: Bearer YOUR_MUAPI_KEY header.
claude.ai / Claude Cowork / other connector UIs with no header field: use the URL-embedded key form instead, https://api.muapi.ai/mcp/YOUR_MUAPI_KEY, via Settings → Connectors → Add custom connector.
Claude Code / Claude Desktop: claude mcp add muapi -e MUAPI_API_KEY=YOUR_MUAPI_KEY -- muapi mcp serve (uses the muapi CLI's stdio transport — Claude Code's HTTP MCP client doesn't reliably inject tools).

Full setup details for every client: muapi.ai/docs/mcp.

As agent instructions (any LLM follows the workflow directly):

Drop a sub-agent's SKILL.md into a Claude Code project's .claude/skills/ directory, paste it into a custom-GPT/Project's system instructions, hand it to an autonomous agent framework as a tool spec, or attach it directly in a chat conversation — then ask the agent to follow it.

Read-only vs. write actions

News monitoring, social sentiment, and review mining are read-only — they observe and summarize, never post or reply anywhere. PR & Communications is draft-only: it produces a statement or talking points as text for review. Publishing any statement is requires-approval-to-publish — no sub-agent in this repo sends, posts, or publishes on its own; a human signs off first.

Status and limitations

Review Mining is Blueprint for its Google reviews source — reputation.review_search is backed by Muapi's already-live seo-business-reviews endpoint for Google Business Profile reviews specifically; Amazon, app-store, and Trustpilot/Tripadvisor sources are still not wired up. The other three sub-agents are Coming Soon: they depend on news-search and social-sentiment capabilities that are not yet live on Muapi. Once those capabilities ship, each SKILL.md will be updated from Blueprint/Coming Soon to a working spec.

Contributing

See Agency Agents OS CONTRIBUTING.md.

License

MIT