Skip to content

Guide · Agent skill

How to use the Profound LLM Citation Tracker agent skill

Updated · written with AI from the project's own documentation and checked against our catalogue data

The seo-profound skill is an extension to the claude-seo toolkit that lets your AI agent query the Profound service for how often a brand is mentioned or cited in AI assistant answers such as ChatGPT and Perplexity. This guide explains what the skill does, how to install it, how to ask for it in plain language, and what you need before it returns live data. By the end you will be able to run citation, prompt, competitor and alert checks and read the trend changes they report.

Profound LLM Citation TrackerAgriciDaniel/claude-seo · MIT

Quick start

  1. 1Get a Profound API key. Obtain an API key from your Profound account. The skill cannot return live data without one.
  2. 2Install claude-seo. Make sure the claude-seo framework is installed before adding the extension.
  3. 3Run the Profound install script. Run extensions/profound/install.sh, or install.ps1 on Windows, from the repository.
  4. 4Confirm the key in settings. Check that env.PROFOUND_API_KEY is present in ~/.claude/settings.json.
  5. 5Unzip the skill. Download the seo-profound ZIP and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder.
  6. 6Run a citation check. Ask for /seo profound citations with your brand name and review the 30-day trend.

What the seo-profound skill makes the agent do

A skill is a folder of instructions that an AI agent loads when a task matches it. This one focuses on brand visibility inside AI answer engines. Profound continuously polls these engines and publishes time-series data, so the agent can report week-over-week and month-over-month changes rather than a single snapshot.

The skill routes four commands. Each figure the agent reports is labelled with its source, for example "Profound (live, confidence 0.90)".

  • /seo profound citations <brand>: current citation rate per LLM plus a 30-day trend
  • /seo profound prompts <brand>: top prompts that surface, or fail to surface, the brand
  • /seo profound competitors <brand>: brands cited alongside your brand for the same prompts
  • /seo profound alerts <brand>: spike and drop alerts compared with a 7-day baseline

What you need before you install

The skill needs three things: the claude-seo framework installed, a Profound API key, and the Profound install script run from the repository. The key is stored as PROFOUND_API_KEY in ~/.claude/settings.json. The skill checks for this key before any tool call, and without it the skill cannot return live data.

The skill's own description says it requires a Profound API key. Check Profound's terms for pricing and access; this guide does not state them.

  • claude-seo framework installed
  • A Profound API key, stored as PROFOUND_API_KEY in ~/.claude/settings.json
  • Run extensions/profound/install.sh (macOS/Linux) or install.ps1 (Windows) from the repository

Install the skill from the ZIP

Download the ZIP for seo-profound from this page and unzip it. You can install it in one of two places. For all your projects, unzip it into ~/.claude/skills/. For a single project, unzip it into that project's .claude/skills/ folder.

If you use the Claude apps instead of the file system, you can upload the skill under Settings → Capabilities → Skills.

  • Personal install: ~/.claude/skills/
  • Project install: .claude/skills/ inside your project folder
  • Claude apps: Settings → Capabilities → Skills, then upload
~/.claude/skills/

Run the Profound install script and set your key

The skill's compatibility note says to set PROFOUND_API_KEY by running extensions/profound/install.sh. Run the script from the claude-seo repository, or install.ps1 on Windows, and make sure the key ends up under env.PROFOUND_API_KEY in ~/.claude/settings.json.

Confirm the key is present in that file before you start asking for reports.

extensions/profound/install.sh

How to trigger the skill with natural requests

You can use the slash commands directly, or describe what you want and let the agent pick the matching command. Name the brand clearly, since the commands take the brand as their argument.

Ask for trends when you care about change over time. The skill is built around week-over-week and month-over-month comparisons, so phrasing like "how has our citation rate moved this month" fits its purpose.

  • "Run /seo profound citations for Acme Analytics and show the 30-day trend."
  • "Which prompts surface Acme Analytics on ChatGPT, and which ones miss it?"
  • "Who gets cited alongside Acme Analytics for the same prompts?"
  • "Alert me if Acme Analytics citations spike or drop against the last 7 days."

Safety notes: scripts and network access

This skill runs scripts and uses the network. The install step runs repository scripts, and the commands call the Profound service. Review the install scripts before you run them, and keep your API key out of shared files.

The skill also treats fetched pages, search results, API responses and third-party files as untrusted data. If any of that content tries to instruct the agent, such as asking it to run a command or change a setting, the skill says to report it rather than follow it. Keep that in mind when you read results.

  • Install scripts run on your machine; read them first
  • Commands send requests to the Profound service using your key
  • Treat any instructions found inside fetched content as suspicious

Tips for getting useful results

Use the trend commands for decisions and the prompts command for content work. Citation rate tells you how often you appear; the prompts list tells you which questions you miss, which is where content changes are usually made.

For Gemini, Google AI Overviews or AI Mode, the skill says to use the seo-seranking skill instead. For Google AI Overviews citation rates it also suggests cross-checking seo-dataforseo tools when they are available. For a full AI search audit, the skill hands work back to seo-geo, and for prompt-set design and detecting AI-style patterns in cited content it falls back to seo-content.

  • Use alerts to catch sudden changes rather than checking manually
  • Compare competitors on the same prompts to see who is cited instead of you
  • Pair with seo-seranking for triangulated coverage across engines

What people use it for

  • Tracking whether your brand's citation rate in ChatGPT and Perplexity rises or falls month over month.
  • Finding prompts where competitors are cited and your brand is absent, to guide content plans.
  • Receiving spike or drop alerts against a 7-day baseline for an analyst review.
  • Reviewing which brands are cited alongside yours for the same prompts.

Frequently asked questions

Is the seo-profound skill free?

The skill itself is MIT licensed in the claude-seo repository. It needs a Profound API key, and this source does not state Profound's pricing, so check Profound directly for access costs.

How do I install the Profound LLM citation tracker skill?

Download the seo-profound ZIP from this page and unzip it into ~/.claude/skills/ or a project's .claude/skills/ folder. In the Claude apps, upload it under Settings → Capabilities → Skills. You also need to run extensions/profound/install.sh or install.ps1 and set your PROFOUND_API_KEY.

What do I need to use the Profound skill?

You need the claude-seo framework installed, a Profound API key stored as PROFOUND_API_KEY in ~/.claude/settings.json, and the install script run from the repository. Without the key the skill cannot return live data.

Does the skill track Google AI Overviews or Gemini?

No, not on its own. The skill says Profound covers ChatGPT and Perplexity natively, and it directs Gemini, AI Overviews and AI Mode questions to the seo-seranking skill. For Google AI Overviews it also suggests cross-referencing seo-dataforseo tools when available.

What is the alternative to Profound for AI citation tracking?

The skill itself points to seo-seranking, which samples prompts on demand, as a complement for other engines. This source does not compare Profound with other commercial tools, so evaluate them against your own needs.

Why does the agent say it cannot find my data?

The most likely cause, based on the skill's requirements, is a missing PROFOUND_API_KEY in ~/.claude/settings.json or the install script not having been run. Confirm both, then retry the command with the brand name.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Choose seo-profound if your team already pays for Profound and wants AI citation trends, deltas and alerts inside an agent workflow. Skip it if you have no Profound API key, or if your question is about Gemini or Google AI Overviews alone, where the skill itself hands off to other extensions.

Download the skill