All skills
webredditnewsforums PR, Reputation & Crisis

AI-SERP Reputation Audit

See what Google's AI tells the public about your brand — then trace that narrative back to the Reddit, news, and forum sources you can actually fix.

Run this skill with your agent
1. Connect the MCP server
https://apidirect.io/mcp?token=YOUR_API_KEY
2. Then ask your agent — name the skill so it runs this exact playbook
Use the ai-serp-reputation-audit skill: What does Google's AI say about {brand}, and which sources is it pulling that from?
Naming the skill (ai-serp-reputation-audit) makes your agent run this exact playbook instead of improvising its own searches. In clients that support MCP prompts (Claude Desktop, Claude Code, Cursor) it also appears as a prompt named ai-serp-reputation-audit, and any agent can call get_skill(skill_id="ai-serp-reputation-audit") directly.

What it does

Captures Google's AI Overview and AI Mode answer about your brand, then traces the narrative back to the cited domains and — optionally — the Reddit threads, news articles, and forum posts feeding it (with sentiment), so you can fix the actual inputs. Choose which source platforms to trace and which market to audit.

Who it's for: PR, brand and SEO teams managing how AI describes them.

Inputs

Input Required Description Example
brand Yes The brand or person to audit. API Direct
platforms No Comma-separated list of platforms to run — options: web, reddit, news, forums. Omit to run all of them; name specific platforms to limit the run. reddit, news, forums
country No Optional. Two-letter country code to localize the AI answer and source searches — AI Overviews differ by market. Omit to use the default market. us
freshness No Optional. How far back to pull cited news sources (maps to news time_published). Omit for all-time. 7d

How your agent runs it

  1. 1
    search_web(query="{brand} reviews", include_ai_overview=true)

    Read ai_overview.text_parts (the public summary) and collect ai_overview.reference_links. Pass {country} to localize the Overview if the user set it.

  2. 2
    google_ai_mode(prompt="What is the reputation of {brand}? Note complaints and praise.")

    Get the fuller conversational answer plus its reference_links citations. Merge these citation domains with the Overview's into one <cited_domains> set.

  3. 3
    search_web(query="site:<cited_domain> {brand}")

    For each domain in <cited_domains>, open the exact pages driving the AI's narrative — these are the pages to fix or pitch.

  4. 4
    search_reddit(query="{brand}", get_sentiment=true, sort_by=relevance)

    Only run if {platforms} includes reddit: Google's AI Overview frequently cites Reddit on reputation queries — pull the actual threads shaping (or about to shape) the narrative, with sentiment, even if they weren't in this week's citations.

  5. 5
    search_news(query="{brand}", time_published=7d)

    Only run if {platforms} includes news: Surface the news articles the AI cites or is likely to cite next. Use {freshness} (e.g. 7d) to bound recency; omit for anytime.

  6. 6
    search_forums(query="{brand}", get_sentiment=true, time=month)

    Only run if {platforms} includes forums: Pull forum and review-site threads commonly cited in AI answers, with sentiment, to find feeding inputs beyond the cited domains.

Delivers: A report: what Google's AI says about the brand, the sources it cites, and the specific pages to fix or pitch — optionally enriched with the Reddit threads, news articles, and forum posts driving the narrative, scored for sentiment.

Tools used

The full playbook

This is exactly what the MCP returns to your agent (via the ai-serp-reputation-audit prompt or get_skill tool), with your inputs filled in.

SKILL: AI-SERP Reputation Audit
Captures Google's AI Overview and AI Mode answer about your brand, then traces the narrative back to the cited domains and — optionally — the Reddit threads, news articles, and forum posts feeding it (with sentiment), so you can fix the actual inputs. Choose which source platforms to trace and which market to audit.

You are running this skill on API Direct via its MCP tools. Execute the steps below yourself by calling the named tools in order — values in <angle brackets> come from a previous step. Then deliver the result described at the end.

INPUTS:
  - brand (required): <brand — ASK THE USER>
      The brand or person to audit.
  - platforms (optional): (optional — e.g. reddit, news, forums)
      Comma-separated list of platforms to run — options: web, reddit, news, forums. Omit to run all of them; name specific platforms to limit the run.
  - country (optional): (optional — e.g. us)
      Optional. Two-letter country code to localize the AI answer and source searches — AI Overviews differ by market. Omit to use the default market.
  - freshness (optional): 7d (default — override if you like)
      Optional. How far back to pull cited news sources (maps to news time_published). Omit for all-time.

PLATFORM SELECTION: some steps are gated with "Only run if {platforms} includes X". If the user supplied a `platforms` value, run only the steps whose platform is listed. If the user did NOT supply `platforms`, run ALL steps — every platform the skill supports.

STEPS:
  1. Tool `search_web` — search_web(query="{brand} reviews", include_ai_overview=true)
     Read ai_overview.text_parts (the public summary) and collect ai_overview.reference_links. Pass {country} to localize the Overview if the user set it.
  2. Tool `google_ai_mode` — google_ai_mode(prompt="What is the reputation of {brand}? Note complaints and praise.")
     Get the fuller conversational answer plus its reference_links citations. Merge these citation domains with the Overview's into one <cited_domains> set.
  3. Tool `search_web` — search_web(query="site:<cited_domain> {brand}")
     For each domain in <cited_domains>, open the exact pages driving the AI's narrative — these are the pages to fix or pitch.
  4. Tool `search_reddit` — search_reddit(query="{brand}", get_sentiment=true, sort_by=relevance)
     Only run if {platforms} includes reddit: Google's AI Overview frequently cites Reddit on reputation queries — pull the actual threads shaping (or about to shape) the narrative, with sentiment, even if they weren't in this week's citations.
  5. Tool `search_news` — search_news(query="{brand}", time_published=7d)
     Only run if {platforms} includes news: Surface the news articles the AI cites or is likely to cite next. Use 7d (e.g. 7d) to bound recency; omit for anytime.
  6. Tool `search_forums` — search_forums(query="{brand}", get_sentiment=true, time=month)
     Only run if {platforms} includes forums: Pull forum and review-site threads commonly cited in AI answers, with sentiment, to find feeding inputs beyond the cited domains.

DELIVER: A report: what Google's AI says about the brand, the sources it cites, and the specific pages to fix or pitch — optionally enriched with the Reddit threads, news articles, and forum posts driving the narrative, scored for sentiment.

Note: each underlying tool call is billed at its normal endpoint price; get_sentiment adds a small per-page surcharge. Page through results as needed but stop once you have enough to deliver the outcome.