{"id":50771339,"url":"https://github.com/DeeeFOX/oh-my-agent-search","last_synced_at":"2026-06-11T19:01:10.748Z","repository":{"id":359800933,"uuid":"1246449219","full_name":"DeeeFOX/oh-my-agent-search","owner":"DeeeFOX","description":"A self-contained, self-hosted-friendly SearXNG search starter for Claude Code through MCP.","archived":false,"fork":false,"pushed_at":"2026-05-23T13:45:14.000Z","size":678,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-23T15:24:56.135Z","etag":null,"topics":["agent-tools","ai-agents","claude-code","developer-tools","local-first","mcp","mcp-tools","model-context-protocol","nodejs","open-source","privacy","search","search-engine","searxng","searxng-mcp","self-hosted","self-hosted-search"],"latest_commit_sha":null,"homepage":"https://github.com/DeeeFOX/oh-my-agent-search#readme","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":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"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-22T07:49:03.000Z","updated_at":"2026-05-23T13:45:17.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/DeeeFOX/oh-my-agent-search","commit_stats":null,"previous_names":["deeefox/oh-my-agent-search"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/DeeeFOX/oh-my-agent-search","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Foh-my-agent-search","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Foh-my-agent-search/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Foh-my-agent-search/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Foh-my-agent-search/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/DeeeFOX","download_url":"https://codeload.github.com/DeeeFOX/oh-my-agent-search/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/DeeeFOX%2Foh-my-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-tools","ai-agents","claude-code","developer-tools","local-first","mcp","mcp-tools","model-context-protocol","nodejs","open-source","privacy","search","search-engine","searxng","searxng-mcp","self-hosted","self-hosted-search"],"created_at":"2026-06-11T19:01:10.148Z","updated_at":"2026-06-11T19:01:10.740Z","avatar_url":"https://github.com/DeeeFOX.png","language":"JavaScript","funding_links":[],"categories":["Why Awesome, Not Oh My"],"sub_categories":[],"readme":"# Oh My Agent Search\n\nEnglish | [中文](README.zh-CN.md)\n\n[![Check](https://github.com/DeeeFOX/oh-my-agent-search/actions/workflows/check.yml/badge.svg)](https://github.com/DeeeFOX/oh-my-agent-search/actions/workflows/check.yml)\n\nClaude Code MCP SearXNG search starter for privacy-aware, self-hosted-friendly agent search.\n\nA self-contained, self-hosted-friendly SearXNG search starter for Claude Code through MCP.\n\nUse this repository to add SearXNG search to Claude Code through a trusted or self-hosted SearXNG endpoint without committing private endpoints, changing MCP config by accident, or relying on random public search instances.\n\nIt focuses on Claude Code MCP search setup with dry-run install, local MCP scope by default, optional user MCP scope, endpoint verification, and public-safe search prompts.\n\n## Why This Exists\n\nCoding agents are more useful with search, but search queries can leak private context. This starter gives Claude Code a repeatable MCP path for SearXNG while keeping the risky parts explicit:\n\n- verify that SearXNG JSON/search works before installing\n- preview MCP config changes before applying them\n- prefer `local` or `user` scope over shared project config\n- keep endpoint values in local MCP config, not in this repository\n- use go-live prompts that check search, lifecycle, and privacy behavior\n\n## Who It Is For\n\n- Claude Code users who want MCP search backed by SearXNG\n- developers testing a local SearXNG instance before using it with an agent\n- developers bringing their own self-hosted or trusted SearXNG endpoint\n- teams that need a small, auditable search starter instead of a general agent catalog\n- agent workflows that need JSON output for automation and status checks\n\n## What This Provides\n\n- Claude Code MCP install and uninstall helpers\n- SearXNG JSON/search verification\n- local SearXNG bootstrap for testing\n- engine probing for regional search availability\n- go-live prompts for smoke, lifecycle, and privacy checks\n- concise security guidance for public-safe search queries\n\n## 5-Minute Quick Start\n\nRun `npm run` and `make` commands from this repository root. From another directory, use `make -C \u003cpath-to-oh-my-agent-search\u003e \u003ctarget\u003e`.\n\nUse a trusted SearXNG endpoint:\n\n```sh\nexport SEARXNG_URL=\"https://search.example.org\"\nmake verify-json URL=\"$SEARXNG_URL\"\nmake verify-search URL=\"$SEARXNG_URL\"\nmake install-preview-check URL=\"$SEARXNG_URL\"\nmake install-apply-check URL=\"$SEARXNG_URL\"\nmake status URL=\"$SEARXNG_URL\"\n```\n\nThen verify Claude Code:\n\n```sh\nclaude mcp list\nclaude mcp get searxng\n```\n\nInside Claude Code:\n\n```text\n/mcp\n```\n\nAfter installation, use [templates/go-live-prompts.md](templates/go-live-prompts.md) to verify real behavior.\n\n## No Endpoint Yet\n\nStart a local SearXNG instance:\n\n```sh\nmake setup-searxng\nnpm run setup:searxng -- --apply --start\nexport SEARXNG_URL=\"http://127.0.0.1:8080\"\nmake verify-search URL=\"$SEARXNG_URL\"\n```\n\nIf the default engines return no results in your region, probe candidate engines first. Start with a candidate set:\n\n```sh\nnpm run setup:searxng -- --engines bing,yandex,google,baidu --apply --force --start\nmake probe-engines URL=\"$SEARXNG_URL\"\n```\n\nThen enable all engines that passed, not just one fallback engine:\n\n```sh\nnpm run setup:searxng -- --engines bing,yandex --apply --force --start\nmake verify-search URL=\"$SEARXNG_URL\"\n```\n\nSingle-engine profiles such as `bing-only` are for troubleshooting.\n\n## Common Use Cases\n\n- Add SearXNG search to one Claude Code project with `local` MCP scope.\n- Reuse one trusted SearXNG endpoint across projects with `user` MCP scope.\n- Test a local SearXNG container before attaching it to Claude Code.\n- Check whether search still works after restarting Claude Code or switching projects.\n- Give another agent JSON status output instead of scraping human-readable logs.\n\n## What Makes It Safer\n\nThe installer is dry-run by default. MCP config changes require `--apply`, and uninstall apply requires an explicit `--scope`.\n\nDefault scope is `local`. Use:\n\n- `local` for one project\n- `user` when the same trusted endpoint should work across projects\n- `project` only after reviewing the shared `.mcp.json`\n\nIf a `searxng` server already exists, check its scope before installing:\n\n```sh\nclaude mcp get searxng\n```\n\nUse SearXNG only for public information. Do not search with secrets, private code, private hostnames, private endpoints, local paths, customer data, or unreleased names that reveal intent.\n\nLocal SearXNG avoids random public instances, but selected upstream search engines still receive the query.\n\n## Uninstall\n\nPreview and apply removal with an explicit scope:\n\n```sh\nmake uninstall-preview SCOPE=local\nmake uninstall-apply SCOPE=local\n```\n\n## Automation\n\nUse JSON output when another agent or script parses command results:\n\n```sh\nnpm --silent run setup:searxng -- --json\nnpm --silent run probe:engines -- --url \"$SEARXNG_URL\" --json\nnpm --silent run verify:search -- --url \"$SEARXNG_URL\" --json\nnpm --silent run install:claude-code -- --url \"$SEARXNG_URL\" --scope local --check-first --json\nnpm --silent run status -- --url \"$SEARXNG_URL\" --json\n```\n\n## Docs\n\nStart with [docs/README.md](docs/README.md).\n\nDiscovery-focused guides:\n\n- [FAQ](docs/faq.md) - short answers for common Claude Code MCP search setup questions.\n- [Comparison](docs/comparison.md) - how this starter differs from generic SearXNG MCP servers.\n- [Local-first example](docs/examples/local-first.md) - one complete local SearXNG to Claude Code walkthrough.\n\nBefore submitting changes:\n\n```sh\nmake review\n```\n\n## License\n\nMIT. See [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDeeeFOX%2Foh-my-agent-search","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FDeeeFOX%2Foh-my-agent-search","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FDeeeFOX%2Foh-my-agent-search/lists"}