{"id":50771332,"url":"https://github.com/deeefox/awesome-agent-search","last_synced_at":"2026-06-11T19:01:10.052Z","repository":{"id":359498246,"uuid":"1245930268","full_name":"DeeeFOX/awesome-agent-search","owner":"DeeeFOX","description":"Research and best practices for bringing web search into Codex, Claude Code, OpenClaw, and AI coding agents.","archived":false,"fork":false,"pushed_at":"2026-05-22T14:20:35.000Z","size":228,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-22T14:24:29.972Z","etag":null,"topics":["agent-search","agent-tools","ai-agents","awesome","awesome-list","brave-search","claude-code","codex","coding-agents","developer-tools","llm-tools","mcp","model-context-protocol","openclaw","privacy","retrieval","search","searxng","tavily","web-search"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/DeeeFOX.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/roadmap/comparison-issues.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-05-21T17:45:21.000Z","updated_at":"2026-05-22T14:19:22.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DeeeFOX/awesome-agent-search","commit_stats":null,"previous_names":["deeefox/awesome-agent-search"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/DeeeFOX/awesome-agent-search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Fawesome-agent-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Fawesome-agent-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Fawesome-agent-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Fawesome-agent-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeeeFOX","download_url":"https://codeload.github.com/DeeeFOX/awesome-agent-search/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Fawesome-agent-search/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34213179,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-11T02:00:06.485Z","response_time":57,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-search","agent-tools","ai-agents","awesome","awesome-list","brave-search","claude-code","codex","coding-agents","developer-tools","llm-tools","mcp","model-context-protocol","openclaw","privacy","retrieval","search","searxng","tavily","web-search"],"created_at":"2026-06-11T19:01:09.113Z","updated_at":"2026-06-11T19:01:10.027Z","avatar_url":"https://github.com/DeeeFOX.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Awesome Agent Search\n\nEnglish | [中文](README.zh-CN.md)\n\n[![Registry](https://img.shields.io/github/actions/workflow/status/DeeeFOX/awesome-agent-search/validate-registry.yml?branch=main\u0026label=registry)](https://github.com/DeeeFOX/awesome-agent-search/actions/workflows/validate-registry.yml)\n![Scope](https://img.shields.io/badge/focus-agent%20search-0b7285)\n![Methods](https://img.shields.io/badge/methods-multi--backend-5c940d)\n![Style](https://img.shields.io/badge/style-awesome--list-7950f2)\n\n\u003e Research and best practices for bringing external search into Codex, Claude Code, OpenClaw, and other coding agents.\n\nA curated, public-safe, AI-readable research hub for agent search integration: native web search, MCP adapters, self-hosted search, hosted search APIs, browser/CDP retrieval, local documentation search, hybrid routing, evaluation, and implementation references.\n\n## Contents\n\n- [Why This Exists](#why-this-exists)\n- [Search Options](#search-options)\n- [For AI Agents](#for-ai-agents)\n- [Why Awesome, Not Oh My](#why-awesome-not-oh-my)\n- [Resources And References](#resources-and-references)\n- [Appendix: Repository Navigation](#appendix-repository-navigation)\n- [Contributing](#contributing)\n\n## Why This Exists\n\nCoding agents increasingly work against a changing external world: documentation, APIs, SDKs, release notes, package behavior, security advisories, product policies, issue threads, benchmarks, examples, and rendered web pages. Local repository context is necessary, but it ages quickly and cannot cover every public source an agent may need.\n\nThis repository helps answer a practical question:\n\n\u003e Which search route should an agent use for this task, and what are the tradeoffs?\n\nIt collects researched options, official entry points, best-practice notes, comparison criteria, and issue-ready research tasks so agent builders can choose between native search, MCP tools, self-hosted search, hosted APIs, browser retrieval, local documentation search, or hybrid routing without starting from a blank page.\n\n## Search Options\n\nThis matrix links concrete options first. `Seeking` means this repository has not confirmed a durable install or deployment best-practice entry yet; `Researching` means a dedicated research report is still missing.\n\n| Solution | Best Practice | Research Report | Strengths | Limitations | Agent Support Matrix |\n| --- | --- | --- | --- | --- | --- |\n| [OpenAI Web Search](https://developers.openai.com/api/docs/guides/tools-web-search) | Seeking | [Search integration strategies](docs/comparisons/search-integration-strategies.md) | Low setup when the selected OpenAI runtime exposes web search; integrated retrieval path. | Less operator control over backend choice, ranking, logs, routing, and reproducibility. | \u003ca href=\"https://developers.openai.com/codex/cloud\"\u003e\u003ccode\u003eCodex\u003c/code\u003e\u003c/a\u003e |\n| [Claude MCP Web Search](https://support.claude.com/en/articles/14503775-mcp-web-search) | Seeking | [Search integration strategies](docs/comparisons/search-integration-strategies.md) | Managed Claude-side route when the product or workspace supports it; minimal custom infrastructure. | Availability depends on Claude product, workspace, account, and region; backend policy is provider-managed. | \u003ca href=\"https://code.claude.com/docs/\"\u003e\u003ccode\u003eClaude Code\u003c/code\u003e\u003c/a\u003e |\n| [SearXNG](https://docs.searxng.org/) | [oh-my-agent-search](https://github.com/DeeeFOX/oh-my-agent-search) | [SearXNG search backend research](docs/research/searxng-search-backend-research.md) | Strong operator control over engines, JSON output, logs, retention, and deployment policy. | Requires operations; engine availability and result quality vary by environment; API-style access needs JSON enabled. | \u003ca href=\"https://code.claude.com/docs/\"\u003e\u003ccode\u003eClaude Code\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://developers.openai.com/codex/cloud\"\u003e\u003ccode\u003eCodex\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://openclaw.ai/\"\u003e\u003ccode\u003eOpenClaw\u003c/code\u003e\u003c/a\u003e |\n| [Brave Search API](https://brave.com/search/api/) | Seeking | [Brave Search API research](docs/research/brave-search-api.md) | Hosted independent-index web search with structured source URLs, freshness controls, country/language targeting, extra snippets, and reranking options. | Requires subscription-token management; cost/quota terms are volatile; privacy, retention, storage rights, and live result quality need review before primary use. | \u003ca href=\"https://developers.openai.com/codex/cloud\"\u003e\u003ccode\u003eCodex\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://code.claude.com/docs/\"\u003e\u003ccode\u003eClaude Code\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://openclaw.ai/\"\u003e\u003ccode\u003eOpenClaw\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://modelcontextprotocol.io/\"\u003e\u003ccode\u003eMCP agents\u003c/code\u003e\u003c/a\u003e |\n| [Tavily API](https://docs.tavily.com/api-reference/introduction) | Seeking | Researching | Agent-oriented API shape; useful for structured retrieval and productized search workflows. | Hosted dependency; cost, quota, data policy, and answer abstraction can reduce transparency. | \u003ca href=\"https://developers.openai.com/codex/cloud\"\u003e\u003ccode\u003eCodex\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://code.claude.com/docs/\"\u003e\u003ccode\u003eClaude Code\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://openclaw.ai/\"\u003e\u003ccode\u003eOpenClaw\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://modelcontextprotocol.io/\"\u003e\u003ccode\u003eMCP agents\u003c/code\u003e\u003c/a\u003e |\n| [DuckDuckGo Instant Answer API](https://duckduckgo.com/api) | Seeking | [DuckDuckGo Instant Answer API research](docs/research/duckduckgo-instant-answer-api.md) | No-key instant-answer JSON can support lightweight facts, entity lookups, definitions, and fallback routing signals. | Not a full web search results API; official documentation visibility is limited; language, freshness, coverage, and schema stability need stronger validation. | \u003ca href=\"https://developers.openai.com/codex/cloud\"\u003e\u003ccode\u003eCodex\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://code.claude.com/docs/\"\u003e\u003ccode\u003eClaude Code\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://openclaw.ai/\"\u003e\u003ccode\u003eOpenClaw\u003c/code\u003e\u003c/a\u003e \u003ca href=\"https://modelcontextprotocol.io/\"\u003e\u003ccode\u003eMCP agents\u003c/code\u003e\u003c/a\u003e |\n| [eze-is/web-access](https://github.com/eze-is/web-access) | Seeking | [eze-is/web-access and Browser Retrieval](docs/research/web-access-browser-retrieval.md) | Handles rendered pages, navigation, interaction, screenshots, and page-state evidence. | Slower and more brittle than search APIs; browser profiles, cookies, sessions, and prompt injection need strict handling. | \u003ca href=\"https://code.claude.com/docs/\"\u003e\u003ccode\u003eClaude Code\u003c/code\u003e\u003c/a\u003e |\n\n## For AI Agents\n\nThis repository is designed to be read by agents, not only humans.\n\nAI agents should:\n\n1. Read [AGENTS.md](AGENTS.md).\n2. Read [registry/resources.json](registry/resources.json).\n3. Pick the closest guide, comparison, research note, or template.\n4. Keep every query, endpoint, path, and example public-safe.\n5. Keep runnable install commands in the installable companion, not in this awesome list.\n6. Run `make review` before submitting changes.\n\nDurable resources must be registered in `registry/resources.json`. Translations should use `language` and `translationOf` metadata.\n\n## Why Awesome, Not Oh My\n\nUse `awesome-agent-search` for this repository because it is a curated research and best-practices hub.\n\nAn `oh-my-*` name implies an installable package, plugin framework, or one-command enhancement bundle. Runnable setup belongs in companion repositories such as [oh-my-agent-search](https://github.com/DeeeFOX/oh-my-agent-search).\n\nSee [Companion repository boundary](docs/companion-repository.md) for the split between curated guidance and runnable setup.\n\n## Resources And References\n\n| Category | Resource | Use it for |\n| --- | --- | --- |\n| Core practice | [Best practices](docs/best-practices.md) | Query design, fallback, logging, citation, and safe contribution rules. |\n| Strategy comparison | [Search integration strategies](docs/comparisons/search-integration-strategies.md) | Choosing between native search, MCP, SearXNG, hosted APIs, browser retrieval, local docs, and hybrid routing. |\n| SearXNG research | [SearXNG search backend research](docs/research/searxng-search-backend-research.md) | Understanding when SearXNG fits agent search and which deployment pattern is appropriate. |\n| Hosted API research | [Brave Search API research](docs/research/brave-search-api.md) | Understanding Brave Search API as a hosted independent-index search candidate for agents. |\n| Fallback research | [DuckDuckGo Instant Answer API research](docs/research/duckduckgo-instant-answer-api.md) | Understanding DuckDuckGo Instant Answer API as a lightweight fallback, not a primary search backend. |\n| Browser route | [eze-is/web-access note](docs/research/web-access-browser-retrieval.md) | Understanding browser/CDP retrieval as a representative Claude Code path. |\n| MCP route | [Claude Code MCP guide](docs/integrations/claude-code-mcp.md) | Routing Claude Code search through explicit MCP tools. |\n| Research queue | [Comparison issue backlog](docs/roadmap/comparison-issues.md) | Publishing focused comparison tasks as GitHub issues. |\n| Registry | [Machine-readable registry](registry/resources.json) and [registry index](docs/registry-index.md) | Letting humans and agents discover durable resources. |\n| Chinese docs | [中文 README](README.zh-CN.md) and [中文文档索引](docs/zh-CN/README.md) | Reading and searching the repository in Chinese. |\n| Reference model | [sindresorhus/awesome](https://github.com/sindresorhus/awesome) | Curated-list conventions. |\n| Reference model | [ohmyzsh/ohmyzsh](https://github.com/ohmyzsh/ohmyzsh) | Community docs and onboarding structure. |\n| Reference model | [subinium/awesome-claude-code](https://github.com/subinium/awesome-claude-code) | AI coding-agent ecosystem taxonomy. |\n| Reference model | [searxng/searx-instances](https://github.com/searxng/searx-instances) | Structured submission and review workflow. |\n\n## Appendix: Repository Navigation\n\n| Audience | Entry point | Use it for |\n| --- | --- | --- |\n| Humans | [Best practices](docs/best-practices.md) | Learn core agent search practices. |\n| AI agents | [AGENTS.md](AGENTS.md) | Follow editing, validation, and privacy rules. |\n| Integrators | [Integration guides](docs/integrations/README.md) | Connect agents to search tools, backends, and adapters. |\n| Researchers | [Research notes](docs/research/README.md) | Read and contribute public-safe findings. |\n| Maintainers | [Submission guide](docs/submission-guide.md) | Review issues, PRs, and registry entries. |\n\nRepository layout:\n\n- [docs/](docs): positioning, architecture, comparisons, integrations, i18n, research, evaluation, roadmap, launch, and submission guidance.\n- [examples/](examples): minimal integration patterns by ecosystem.\n- [registry/resources.json](registry/resources.json): machine-readable catalog.\n- [templates/](templates): reusable integration and research templates.\n- [schemas/](schemas): schema for structured registry data.\n\n## Contributing\n\nRead [CONTRIBUTING.md](CONTRIBUTING.md), [SECURITY.md](SECURITY.md), and [AGENTS.md](AGENTS.md) before opening a PR.\n\nRun:\n\n```sh\nmake review\n```\n\nSubstantial contributions should state the problem, approach, expected benefit, privacy considerations, and acceptance criteria.\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeefox%2Fawesome-agent-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdeeefox%2Fawesome-agent-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdeeefox%2Fawesome-agent-search/lists"}