Documentação

Agentes de IA (MCP)

Receitas

Prompts prontos para copiar e colar para agentes de IA conectados ao AmICited por MCP: um briefing semanal, investigar uma queda, encontrar lacunas de citação, escrever um artigo para um prompt ausente e mais.

Estes prompts funcionam em qualquer cliente conectado ao servidor MCP do AmICited. Substitua example.com pelo seu domínio. Sob cada um, você encontra o que o agente faz, para distinguir uma boa execução de um atalho.

Alguns hábitos melhoram todas as receitas:

  • Nomeie o domínio. A maioria das ferramentas precisa de um domain_id, e um workspace costuma rastrear vários domínios. Nomeá-lo poupa o agente de um palpite.
  • Nomeie a janela. “Últimos 28 dias contra os 28 anteriores” dá números comparáveis. Veja a skill report-windows.
  • Peça links. Os agentes podem chamar report_link para dar a você um link funcional para o relatório por trás de uma descoberta.

Relatórios#

Briefing semanal de visibilidade em IA#

text
Give me a weekly AI visibility briefing for example.com: the last 7 days
against the 7 days before. Headline KPIs with changes, the prompts we
gained and lost, which engines moved, the competitors whose share of voice
grew, and the sites cited most often. Note any annotations in the period.
End with the three things worth doing next, each with a link to the report.

O que o agente faz: list_domains para resolver o domínio, get_dashboard_metrics para os KPIs, variações, detalhamento por plataforma e Share of Voice dos concorrentes, get_prompts_metrics para ganhos e perdas por prompt, list_top_cited_domains para os sites mais citados, annotation_get_overlay para as mudanças registradas no período e report_link para os links. Ele deve ler a skill recurring-reports para que o briefing da próxima semana use as mesmas janelas e ferramentas.

Panorama mensal dos concorrentes#

text
For example.com, compare our AI share of voice with each tracked competitor
over the last 30 days against the previous 30. Which competitor gained the
most, on which engines, and on which prompts are they named when we are not?

O que o agente faz: list_competitors e depois get_dashboard_metrics para o Share of Voice dos concorrentes (que cobre toda marca citada, não apenas as rastreadas) e get_prompts_metrics filtrado por mecanismo para encontrar os prompts em que você está ausente. Ele segue a skill competitor-gap-analysis, que alerta que contagens brutas de menções podem apontar para o concorrente errado.

Diagnosticar#

Investigar uma queda de visibilidade#

text
Our AI visibility for example.com dropped this week. Use the
ai-visibility-audit skill to find out why. Check whether the prompt set or
engines changed, which engines ran but stopped citing us, and whether any
annotation lines up with the drop. Tell me what changed, not just the number.

O que o agente faz: lê skill://ai-visibility-audit/SKILL.md, compara get_dashboard_metrics nas duas janelas e depois se aprofunda em get_prompt_detail para os prompts que você perdeu, onde cada mecanismo mostra se rodou e se citou você. Ele consulta list_prompts para prompts adicionados no período (novos prompts diluem a pontuação de visibilidade) e annotation_list para mudanças no site. Veja por que minha pontuação caiu? para as mesmas verificações feitas à mão.

Os rastreadores de IA conseguem ler nosso site?#

text
Check whether AI engines can read example.com: robots.txt rules for AI
crawlers, llms.txt, the accessibility tree and Common Crawl reach. Compare
our llms.txt with the domains that get cited for our prompts.

O que o agente faz: get_agent_accessibility para o robots.txt, a árvore de acessibilidade e a presença no Common Crawl, llms_txt_get_latest para a revisão do seu llms.txt e llms_txt_get_comparison para comparar com os domínios citados. Ele deve apresentar a comparação do llms.txt como uma correlação, não como uma causa comprovada.

Encontrar oportunidades#

Encontrar lacunas de citação#

text
For example.com, find the queries where we rank well in Google but AI
assistants never cite us, and the pages AI cites that rank poorly in
Google. Skip queries without enough runs to be reliable. Group the results
by intent and rank them by search volume.

O que o agente faz: seo_get_citation_gap_invisible_winners para boa posição sem citação e seo_get_citation_gap_inverse para páginas citadas que ranqueiam mal (uma lacuna de promoção, não de conteúdo). Ambos exigem dados do Search Console; se faltarem, o agente deve dizer isso e indicar Fontes de dados em vez de informar um resultado vazio. Veja o relatório de lacunas de citação.

Em quais sites citados deveríamos estar?#

text
List the domains AI engines cite most for example.com's prompts in the
last 30 days, excluding our own site and our competitors' sites. For the
top 10, tell me which prompts cite them and whether we are mentioned there.

O que o agente faz: list_top_cited_domains e get_sources_metrics para os sites de terceiros mais citados e depois get_source_detail para os prompts em que cada um aparece. São os sites de avaliações, diretórios e artigos de lista em que vale a pena entrar. Veja Fontes.

Agir#

Escrever um artigo para um prompt que estamos perdendo#

text
Find the prompt for example.com with the highest search volume where we are
never mentioned and no article exists yet. Show me the fan-out questions no
page of ours answers, then generate a comparison article targeting that
prompt and those gaps. Tell me when the draft is ready.

O que o agente faz: get_prompts_metrics filtrado por prompts ausentes sem artigo, ordenados por volume, e depois get_prompt_coverage para as perguntas de fan-out sem cobertura (cobertura de prompts). Ele chama article_generate por run_tool (isso conta na sua cota mensal de artigos e exige acesso de escrita) e depois consulta article_get até o status deixar de ser “generating”. O rascunho aparece em Articles. Veja artigos de IA.

Ampliar o conjunto de prompts a partir de uma página#

text
Suggest 15 buyer prompts for example.com based on https://example.com/pricing/,
skip any we already track, and show me the list before adding anything.
After I approve, add them tagged "pricing", daily, in the US.

O que o agente faz: lê a skill prompt-set-design, chama generate_prompts_from_url (nada é salvo) e depois lookup_prompts_bulk para descartar os prompts que você já rastreia. Após sua aprovação, chama create_prompts_bulk por run_tool com uma tag, programação e país. Novos prompts usam créditos a cada execução, então o agente não deve adicioná-los sem perguntar.

Registrar uma mudança e medi-la#

text
We rewrote https://example.com/features/ today. Log an annotation for that
URL and set an expectation that our AI visibility improves within 30 days.
In a month, ask me to check whether it worked.

O que o agente faz: annotation_get_metric_registry para as chaves de métrica válidas e depois annotation_create com o escopo de URL e um marco. Mais tarde, annotation_get_progress mostra a métrica contra sua linha de base, e a skill did-our-change-work cobre a leitura do resultado. Veja anotações.

Relacionados#