Skip to content

Latest commit

 

History

7 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

AI Reputation Agent

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 Open Business Agents, an open ecosystem of specialized AI agents for real business work.

Related Projects

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

  1. Create a Muapi account and API key at muapi.ai.
  2. Review the Muapi API quickstart and OpenAPI schema for the reputation, social, and review endpoints.
  3. 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.

Guides

Contributing

See Open Business Agents CONTRIBUTING.md.

License

MIT