Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add OpenClaudia/openclaudia-skills --skill ai-citations-report -a claude-code
Open on GitHub

What 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.com with the brand name Example Inc.
  • Find the Google AI Overview and ChatGPT prompts that cite example.com.
  • Include citation coverage for my-article-slug and https://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-code

2Manually: put the files in place

~/.claude/skills/ai-citations-report/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ai-citations-report/

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

Similar skills

All skills for SEO and GEO →

From the same set73

The whole set →
similarweb-traffic similarweb-traffic fetches domain traffic estimates from SimilarWeb: monthly visits, acquisition channels, top countries, and search terms without an API key. CX Codex +1 227installs geo-query-finder geo-query-finder runs long-tail queries through ChatGPT with web search and reports which answers surface your brand. Useful when you need to check GEO visibility. CX Codex +1 222installs github-stars github-stars renders terminal charts showing daily and hourly star growth for any GitHub repo in your chosen timezone. Track launches, Product Hunt spikes, or DevRel momentum in real time. CX Codex +1 197installs organize-skills organize-skills audits a skill library, applies names based on backend dependencies, and repairs links and references affected by renames. Useful when several tool hubs share the same library. CX Codex +1 139installs geo-analysis geo-analysis runs a GEO/SEO analysis for a domain through the Enception API and downloads a PDF on AI visibility, the market and competitors. Handy for client audits. CX Codex +1 135installs geo-difficulty geo-difficulty scores how hard a keyword is to rank for by checking page-level authority of real competitors, AI Overview citations, and the site's current position. CX Codex +1 134installs marketing-slides marketing-slides writes the outline for a pitch or sales deck, then, once you approve it, generates the slides in ChatSlide. CX Codex +1 132installs task-banner task-banner displays a persistent macOS desktop banner when Claude Code finishes a task, with a one-line summary of what was done. Works even when Notification Center silently drops CLI notifications. CX Codex +1 126installs

Project sponsors

Companies that keep this analytics open