# 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.

## Before you paste

- Connect the FreshlyCited MCP server in your agent first (see [Quickstart](https://freshlycited.com/docs/quickstart)).
- Replace `example.com` with your domain.
- Optional: [verify the domain for IndexNow](https://freshlycited.com/docs/recipes/verify-site-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_confirmation` until the user agrees (see [Rate limits](https://freshlycited.com/docs/rate-limits)).
- **Honest reporting**: FreshlyCited makes the crawl request and measures the result; search engines decide what they index and cite.


---
Source: https://freshlycited.com/docs/agents-md