Imported from CyranoB/web-forager (AGENTS.md). Install upstream with npx skills add CyranoB/web-forager. Copyright stays with the author.

Repository guidance

Name: web-forager
Author: CyranoB

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.py as generated by setuptools_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.md documentation 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.

{ "ocm": "1", "id": "cyranob-web-forager-web-forager", "kind": "skill", "name": "web-forager", "description": "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/`.", "publisher": "CyranoB", "version": "1.0.0", "capabilities": { "domains": [ "general" ], "tags": [ "skill-md", "github-agents" ], "languages": [ "en" ] }, "quality_prior": 0.6, "examples": [ "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/`." ], "primary": false, "metadata": { "source": { "provider": "github-agents", "repository": "https://github.com/CyranoB/web-forager", "path": "AGENTS.md", "ref": "ef17c225fd11c2f4d8f0da76bd9cf3d50f9e3815", "url": "https://github.com/CyranoB/web-forager/blob/ef17c225fd11c2f4d8f0da76bd9cf3d50f9e3815/AGENTS.md", "key": "CyranoB/web-forager/AGENTS.md" } }, "instructions": "# Repository guidance\n\n## Purpose\n\nWeb Forager provides web search, news search, and URL fetching for AI agents. It\nexposes the capabilities through a FastMCP STDIO server and a CLI, and packages\nagent workflows under `skills/`.\n\nSearch and news use `ddgs`. Fetching tries direct HTTP with `trafilatura`, then\nfalls back to Jina Reader.\n\n## Change contract\n\n- Read the relevant implementation and tests before editing.\n- Keep changes focused and consistent with existing patterns.\n- Treat `src/web_forager/_version.py` as generated by `setuptools_scm`.\n- For skill, plugin, or release changes, follow", "cost": { "context_tokens": 354 } }

web-forager

About

Repository guidance

Purpose

Change contract

Development

Agent workflow references

Use it

Manifest

Reviews