Borrowing it
Nothing to install: this file belongs to CyranoB/web-forager. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/CyranoB/web-forager/main/AGENTS.mdgit clone --depth 1 https://github.com/CyranoB/web-foragerWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/cyranob/web-forager/agents-md)<a href="https://agentmods.dev/instructions/cyranob/web-forager/agents-md"><img src="https://agentmods.dev/badge/instructions/cyranob/web-forager/agents-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/cyranob/web-forager/agents-md"><img src="https://agentmods.dev/badge/instructions/cyranob/web-forager/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00320 | $0.00320 |
| Opus 5.5 | $0.00128 | $0.00128 |
| Sonnet 5.5 | $0.00064 | $0.00064 |
| Haiku 4.5 | $0.00032 | $0.00032 |
Grade A, and why
web-forager AGENTS.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
Repository guidance
Purpose
Web Forager provides web search, news search, and URL fetching for AI agents. It
exposes the capabilities through a FastMCP STDIO server and a CLI, and packages
agent workflows under skills/.
Search and news use ddgs. Fetching tries direct HTTP with trafilatura, then
falls back to Jina Reader.
Change contract
- Read the relevant implementation and tests before editing.
- Keep changes focused and consistent with existing patterns.
- Treat
src/web_forager/_version.pyas generated bysetuptools_scm. - For skill, plugin, or release changes, follow
docs/versioning.md. Bump the shared plugin version in the same PR as a skill change. - When CLI flags or MCP tool behavior changes, update the corresponding tests
and
README.mddocumentation in the same change. - Keep credentials and other secrets out of source, configuration, fixtures, logs, and documentation.
Development
Install the development dependencies:
uv pip install -e ".[dev]"
Run the narrowest relevant test first, then use the full checks when the change can affect multiple components:
pytest
mypy src
black --check src
isort --check-only src
Use the CLI smoke tests documented in README.md when changing search, news,
fetch, or CLI behavior.
Agent workflow references
- Before editing README prose or structure, read
docs/agents/readme-style.md.
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 1mo ago Changed · +2 lines · +34 tokens per session 10a60b9e042f
- 2mo ago First seen · 47 lines · 286 tokens per session scan A ae2ddf3630c4
web-forager AGENTS.md is an instructions file published in the GitHub repository CyranoB/web-forager (11 stars, last pushed 27d ago), licensed MIT. It adds 320 tokens to every session, about $0.0013 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
web-forager AGENTS.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| web-forager AGENTS.mdCyranoB/web-forager | Instructions file | 11 | 27d ago | MIT | A | 320 | Codex, OpenCode |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 143k | yesterday | MIT | A | 7,461 | Codex, OpenCode |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 149k | yesterday | MIT | A | 4,680 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 5,516 | GitHub Copilot |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 195k | yesterday | MIT | A | 3,093 | GitHub Copilot |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 274k | 2d ago | MIT | A | 4,313 | Codex, OpenCode |