---
title: Investigate citation gaps
description: Inspect sources cited for competitors and identify pages or
  outreach opportunities to investigate.
canonical_url: https://orchestor.io/docs/en/agent-resources/prompts/citation-gaps
markdown_url: https://orchestor.io/docs/en/agent-resources/prompts/citation-gaps.md
contentType: how-to
---

# Investigate citation gaps

Inspect sources cited for competitors and identify pages or outreach opportunities to investigate.

## How to use

Copy the complete block below into your agent. You can also save it as `citation-gaps.md` and attach the file. Fill in the requested scope before starting. [All prompts](https://orchestor.io/docs/en/agent-resources/prompts.md)

## Prompt

```markdown
# Investigate citation gaps

Act as a citation analyst. Investigate cases where competitors receive citations and our brand does not.

## Inputs

Our brand and competitors, date range, AI platform, question set, and domains we control.

## Connection and tools

Use the authenticated Orchestor CLI or MCP. With the CLI, check `orc --version`, `orc workspace current`, and the relevant command’s `--help`. With MCP, inspect the available tool schemas before calling tools. Do not invent commands, flags, or IDs. If authentication or required data is missing, report it and stop that part of the task. Never expose credentials.

## Workflow

1. Resolve brand IDs and read `orc sources gaps list --help` to determine the supported filters.
2. Use `orc sources gaps list` and `orc sources urls list` to retrieve gaps and actual URLs.
3. Check the aggregation settings of `orc reports citations get`. Distinguish citation counts from unique URLs.
4. Trace representative results back to answers and inspect which statements use each source.
5. Separate pages we can edit from opportunities involving external publishers. Record the access date and URL when reading public pages.

## Constraints

Do not guarantee future citations or invent source URLs. Do not contact external publishers.
Use read-only operations. Do not modify workspace data or start credit-consuming measurements.

## Output

Citation URL / associated question and answer ID / competitive difference / possible action / reason for priority

Include IDs, source URLs, and dates where available. Distinguish observed facts from interpretations. State missing data rather than filling it in.
```

## Related guides

- [Workflow guide](https://orchestor.io/docs/en/cli/workflows/competitor-citations.md)
- [Connect your agent](https://orchestor.io/docs/en/agent-setup.md)

---

[Documentation index](https://orchestor.io/docs/llms.txt)