ai-citations-report — Claude Code skill: report and install
ai-citations-report is a Claude Code skill that builds GEO reports for a domain. It checks Google AI Overview and ChatGPT prompts that cite the site and identifies content gaps.
MIT 136 installs ★ 750 updated 2026-10-21
npx skills add OpenClaudia/openclaudia-skills --skill ai-citations-report -a claude-codeWhat ai-citations-report does
ai-citations-report sends a domain to the Enception AI Citations API and returns a PDF, HTML, or JSON report. It lists prompts that cited or retrieved the domain, adds organic traffic context with a month-over-month trend, and shows answer cards with the cited source highlighted.
You can pass article slugs or full URLs for per-article citation coverage. The API handles the LLM Mentions pull, cited-versus-retrieved classification, traffic calculations, and PDF generation. Set ENCEPTION_API_KEY first; the report cannot run without it.
The service uses a paid API, with a free key tier covering 10 reports per month. Requests are limited to 20 per hour, and the traffic figures are labelled as DataForSEO modelled estimates rather than analytics measurements.
What it helps with
- check which AI prompts cite a domain
- spot prompts that retrieve content without citing it
- compare AI citations with organic traffic
- measure citation coverage for selected articles
- export a GEO report as PDF
Example prompts for the agent
- Create an AI citations report for
example.comwith the brand nameExample Inc. - Find the Google AI Overview and ChatGPT prompts that cite
example.com. - Include citation coverage for
my-article-slugandhttps://example.com/articles/another-post.
How to install ai-citations-report
1Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill ai-citations-report -a claude-code2Manually: put the files in place
~/.claude/skills/ai-citations-report/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ai-citations-report/
1Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill ai-citations-report -a codex2Manually: put the files in place
.agents/skills/ai-citations-report/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill ai-citations-report -a cursor2Manually: put the files in place
.cursor/skills/ai-citations-report/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install OpenClaudia/openclaudia-skills skills/ai-citations-report2Manually: put the files in place
.github/skills/ai-citations-report/SKILL.md1Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill ai-citations-report -a gemini-cli2Platform CLI
gemini skills install https://github.com/OpenClaudia/openclaudia-skills --path skills/ai-citations-reportManually: put the files in place
.devin/skills/ai-citations-report/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add OpenClaudia/openclaudia-skills --skill ai-citations-report -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ai-citations-report
How do I install ai-citations-report in Claude Code?
Run npx skills add OpenClaudia/openclaudia-skills --skill ai-citations-report -a claude-code, then check ~/.claude/skills/ai-citations-report/SKILL.md.
What does ai-citations-report do?
It creates a GEO report for a domain across Google AI Overview and ChatGPT. The report covers cited and retrieved prompts, organic traffic context, and citation coverage for supplied articles.
What does ai-citations-report need to run?
You need ENCEPTION_API_KEY for the paid Enception API. Its free key tier allows 10 reports per month, and the request limit is 20 per hour.
Source text
SKILL.md · MIT
---
name: ai-citations-report
description: "Generate an AI Citations Report (GEO) for a domain — which AI-search prompts cite the site across Google AI Overview and ChatGPT, plus organic-traffic context and per-article citation coverage. Use when the user asks for an 'AI citations report', 'GEO citations report', or 'which AI prompts cite <domain>'."
---
# AI Citations Report
Generate a styled, client-ready GEO report showing which AI-search prompts cite a domain across Google AI Overview and ChatGPT.
This skill is a thin client over the **Enception AI Citations API** (`POST https://www.enception.ai/api/external/ai-citations`). Do not re-implement the data pull or report HTML locally — all logic (LLM Mentions pull, cited-vs-retrieved classification, traffic trend, content coverage, HTML→PDF) runs server-side.
**Disclosure:** This skill was contributed by Enception AI and calls Enception's **paid** API. Citation data comes from DataForSEO LLM Mentions; traffic figures are modelled estimates.
API docs: https://www.enception.ai/doc/api-ai-citations
## Requirements
- `ENCEPTION_API_KEY` — access key for the Enception API. Self-serve: sign up at https://www.enception.ai, then generate a free-tier key under Account → API Key (10 reports/month free; contact the team for higher limits).
## What it produces
A styled PDF (or HTML/JSON) with:
- Summary table of every prompt that **cited** or **retrieved** the domain
- Organic traffic, 12-month month-over-month trend, and position distribution
- Full cited-prompt answer cards with the domain's source highlighted
- Retrieved-but-not-cited gap cards (content opportunities)
- Optional per-article citation coverage for URLs you pass in
## How to run
```bash
curl -X POST https://www.enception.ai/api/external/ai-citations \
-H 'Content-Type: application/json' \
-d '{
"domain": "example.com",
"brandName": "Example Inc",
"locationCode": 2840,
"articles": ["my-article-slug", "https://example.com/articles/another-post"],
"passcode": "'"$ENCEPTION_API_KEY"'"
}' \
-o ai-citations-example.com.pdf
```
Then open the PDF and visually verify (traffic cards, trend deltas, source highlights) before presenting it.
### Options
- `domain` (required) — the site to analyze.
- `brandName`, `locationCode`, `languageCode`, `genDate` (optional) — default to the domain, `2840` (US), `en`, and today. Common location codes: `2840` = US, `2826` = UK, `2124` = Canada.
- `articles[]` (optional) — article slugs or full URLs for the content-coverage section. Omit to skip that section.
- `format` (optional) — `pdf` (default), `html`, or `json` (`json` returns `{citedCount, retrievedCount, promptCount, html}`; useful for debugging or piping counts elsewhere).
## Honesty guardrails (enforced in the report template)
- Says **"not yet cited in AI answers"**, never "not indexed" — LLM Mentions verifies AI citations, not Google indexation.
- Traffic is labelled **modelled estimates** (DataForSEO), not measured analytics.
- Never promise future AI citations in client-facing docs — citations are an emergent outcome of content quality, not a deliverable you can guarantee.
## Notes
- Rate limit: 20 requests/hour.
- A domain with zero AI citations still gets a valid report — the gap cards and traffic context are the value in that case.
© OpenClaudia · MIT · OpenClaudia/openclaudia-skills