AGENTS.md snippet for FreshlyCited
Coding agents (Claude Code, Cursor, Codex, Copilot…) read AGENTS.md or CLAUDE.md at the root of a repository. Paste the snippet below so that after the agent ships or changes public pages, it checks them and gets them crawled with FreshlyCited, without guessing at prices or overpromising.
The story · 3 steps
Get an API keyFree plan: 10 free links to try (once you verify your email), then 100 free checks a month, no card.
Before you paste
- Connect the FreshlyCited MCP server in your agent first (see Quickstart).
- Replace
example.comwith your domain. - Optional: verify the domain for IndexNow so pushes also reach Bing.
The snippet
markdown
## Getting new pages seen (FreshlyCited)
This project uses the FreshlyCited MCP server (https://freshlycited.com/mcp) to get new and
updated public pages crawled and to check what search engines see.
When you add or substantially change public pages on example.com:
1. Collect the full public URLs (production, https, no drafts or staging).
2. Call `submit_index_job` with `{ "urls": [...], "smart": true }` (we re-check on day 1, 3 and 7).
smart=true checks first and only pushes URLs Google doesn't show yet.
3. Report the outcome headline from the result to the user.
Rules:
- Credits: check 1 check credit/URL; push 1 index credit/URL, used only if
indexed (credit back after 7 days if not). If a tool returns needs_confirmation,
ask the user before calling again with confirm_spend: true.
- Don't push the same URLs again within 24 hours unless the content changed.
- Never claim a page is indexed or will be cited. Say what the check showed,
e.g. "4 of 5 seen by Google; we re-check on Monday".
- IndexNow (Bing, Copilot, Yandex…) is automatic for verified domains and
free. It does not reach Google, ChatGPT or Perplexity.
- Unsure what to do? Call `get_started`.Why these rules
- smart: true saves index credits: URLs Google already shows aren't pushed, and their reserved credit comes straight back.
- The confirmation guard matches the server: calls that would spend more than 1,000 credits return
needs_confirmationuntil the user agrees (see Rate limits). - Honest reporting: FreshlyCited makes the crawl request and measures the result; search engines decide what they index and cite.