Documentatie

AI-agents (MCP)

Recipes

Prompts om te kopiëren voor AI-agents die via MCP aan AmICited zijn gekoppeld: een wekelijkse briefing, een daling onderzoeken, bronvermeldingskloven vinden, een artikel schrijven voor een ontbrekende prompt en meer.

Deze prompts werken in elke client die is gekoppeld aan de AmICited MCP-server. Vervang example.com door je domein. Onder elke prompt lees je wat de agent doet, zodat je een goede run van een sluiproute kunt onderscheiden.

Een paar gewoonten maken elke recipe beter:

  • Noem het domein. De meeste tools hebben een domain_id nodig en een workspace volgt vaak meerdere domeinen. Het noemen ervan bespaart de agent een gok.
  • Noem de periode. “Laatste 28 dagen tegenover de 28 ervoor” geeft vergelijkbare cijfers. Zie de report-windows-skill.
  • Vraag om links. Agents kunnen report_link aanroepen om je een werkende link te geven naar het rapport achter een bevinding.

Rapportage#

Wekelijkse briefing over AI-zichtbaarheid#

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.

Wat de agent doet: list_domains om het domein te bepalen, get_dashboard_metrics voor de KPI’s, verschillen, platformverdeling en Share of Voice van concurrenten, get_prompts_metrics voor winsten en verliezen per prompt, list_top_cited_domains voor de meest aangehaalde sites, annotation_get_overlay voor wijzigingen die in de periode zijn vastgelegd en report_link voor de links. Hij zou de skill recurring-reports moeten lezen zodat de briefing van volgende week dezelfde periodes en tools gebruikt.

Maandelijkse momentopname van concurrenten#

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?

Wat de agent doet: list_competitors, daarna get_dashboard_metrics voor de Share of Voice van concurrenten (die elk genoemd merk dekt, niet alleen gevolgde), en get_prompts_metrics gefilterd op engine om de prompts te vinden waarop je ontbreekt. Hij volgt de skill competitor-gap-analysis, die waarschuwt dat ruwe vermeldingsaantallen naar de verkeerde concurrent kunnen wijzen.

Diagnosticeren#

Een zichtbaarheidsdaling onderzoeken#

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.

Wat de agent doet: leest skill://ai-visibility-audit/SKILL.md, vergelijkt get_dashboard_metrics over de twee periodes en duikt dan in get_prompt_detail voor de prompts die je verloor, waar elke engine toont of hij liep en of hij je aanhaalde. Hij controleert list_prompts op prompts die in de periode zijn toegevoegd (nieuwe prompts verdunnen de zichtbaarheidsscore) en annotation_list op sitewijzigingen. Zie waarom daalde mijn score? voor dezelfde controles handmatig.

Kunnen AI-crawlers onze site lezen?#

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.

Wat de agent doet: get_agent_accessibility voor robots.txt, de toegankelijkheidsboom en aanwezigheid in Common Crawl, llms_txt_get_latest voor je llms.txt-review en llms_txt_get_comparison om te vergelijken met aangehaalde domeinen. Hij zou de llms.txt-vergelijking als correlatie moeten presenteren, niet als bewezen oorzaak.

Kansen vinden#

Bronvermeldingskloven vinden#

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.

Wat de agent doet: seo_get_citation_gap_invisible_winners voor goede rank zonder bronvermelding en seo_get_citation_gap_inverse voor pagina’s die worden aangehaald maar slecht ranken (een promotiekloof in plaats van een contentkloof). Beide vereisen Search Console-data; als die ontbreekt, zou de agent dat moeten zeggen en naar Data Sources moeten linken in plaats van een leeg resultaat te rapporteren. Zie het rapport bronvermeldingskloof.

Op welke sites moeten we staan?#

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.

Wat de agent doet: list_top_cited_domains en get_sources_metrics voor de meest aangehaalde externe sites, daarna get_source_detail voor de prompts waarin elk voorkomt. Dit zijn de reviewsites, gidsen en lijstartikelen waarop het de moeite waard is te komen. Zie Bronnen.

Actie ondernemen#

Een artikel schrijven voor een prompt waarop we ontbreken#

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.

Wat de agent doet: get_prompts_metrics gefilterd op ontbrekende prompts zonder artikel, gesorteerd op volume, daarna get_prompt_coverage voor de niet-gedekte fan-outvragen (promptdekking). Hij roept article_generate aan via run_tool (dit gaat af van je maandelijkse artikeltegoed en vereist schrijftoegang) en pollt daarna article_get totdat de status niet meer “generating” is. Het concept verschijnt onder Articles. Zie AI-artikelen.

De promptset uitbreiden vanuit een pagina#

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.

Wat de agent doet: leest de skill prompt-set-design, roept generate_prompts_from_url aan (er wordt niets opgeslagen) en daarna lookup_prompts_bulk om prompts die je al volgt te laten vallen. Na je goedkeuring roept hij create_prompts_bulk aan via run_tool met één tag, schema en land. Nieuwe prompts verbruiken bij elke run credits, dus de agent zou ze niet zonder te vragen moeten toevoegen.

Een wijziging vastleggen en meten#

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.

Wat de agent doet: annotation_get_metric_registry voor geldige metricsleutels, daarna annotation_create met de URL-scope en een controlepunt. Later toont annotation_get_progress de metric tegenover zijn basislijn, en de skill did-our-change-work behandelt het lezen van de uitkomst. Zie annotaties.

Gerelateerd#