timesfm
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Multi-engine web search with RRF fusion and Jina reranking, plus a tiered fetcher.
Skills that teach the AI this kind of work; they work alongside this one
TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.
Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…
scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 4/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 16/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Let your AI install it with one sentence
Please install Agg Search. Follow https://mcp.popnx.com/i/tsukimiorinka-agg-search.md, show me the commands and wait for my OK before running them.Paste it into an AI that can work on your computer (such as Claude Code or Cursor). It reads our steps, shows you the commands and waits for your OK. No key, no sign-up. · See the full text your AI reads
Passed 3/3 checks · Runs on your computer · ✓ Commands checked Nov 21, 2026
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time) · Only the Claude desktop app (Windows or Mac), not the web or phone
Copy this message into a Claude chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Agg Search for Claude on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "agg-search": { "command": "uvx", "args": [ "agg-search", "agg-search-mcp" ], "env": { "EXA_API_KEY": "your-value", "BRAVE_API_KEY": "your-value", "SERPER_API_KEY": "your-value", "MCP_ANYSEARCH_API_KEY": "your-value", "FIRECRAWL_API_KEY": "your-value", "TAVILY_API_KEY": "your-value", "DEEPSEEK_API_KEY": "your-value", "JINA_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Agg Search tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
SettingsDeveloperEdit Config
{
"mcpServers": {
"agg-search": {
"command": "uvx",
"args": [
"agg-search",
"agg-search-mcp"
],
"env": {
"EXA_API_KEY": "your-value",
"BRAVE_API_KEY": "your-value",
"SERPER_API_KEY": "your-value",
"MCP_ANYSEARCH_API_KEY": "your-value",
"FIRECRAWL_API_KEY": "your-value",
"TAVILY_API_KEY": "your-value",
"DEEPSEEK_API_KEY": "your-value",
"JINA_API_KEY": "your-value"
}
}
}
}Paste the key only into the app’s field, never into a chat or to anyone
Use Agg Search and tell me what you can do for me, then show me one thing✓ If Claude says it is using Agg Search or shows a Agg Search tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SEARXNG_URL Self-hosted SearXNG base URLAGG_SEARCH_PORTAL Portal preset ( . , e.g. codex.academic)AGG_SEARCH_PROFILE Domain profile override (general, academic, code, news)Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect Agg Search yet
Agg Search runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect Agg Search
Works with Claude Code, with some setup first
You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a Claude Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Agg Search for Claude Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): claude mcp add --scope user agg-search --env EXA_API_KEY=your-value --env BRAVE_API_KEY=your-value --env SERPER_API_KEY=your-value --env MCP_ANYSEARCH_API_KEY=your-value --env FIRECRAWL_API_KEY=your-value --env TAVILY_API_KEY=your-value --env DEEPSEEK_API_KEY=your-value --env JINA_API_KEY=your-value -- uvx agg-search agg-search-mcp 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Agg Search tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
Mac: press Command+Space and type Terminal · Windows: open PowerShell
claude mcp add --scope user agg-search --env EXA_API_KEY=your-value --env BRAVE_API_KEY=your-value --env SERPER_API_KEY=your-value --env MCP_ANYSEARCH_API_KEY=your-value --env FIRECRAWL_API_KEY=your-value --env TAVILY_API_KEY=your-value --env DEEPSEEK_API_KEY=your-value --env JINA_API_KEY=your-value -- uvx agg-search agg-search-mcpReplace “your-value” with your key before pressing Enter
Paste the key only into the app’s field, never into a chat or to anyone
You should see Agg Search listed as connected
Use Agg Search and tell me what you can do for me, then show me one thing✓ If Claude Code says it is using Agg Search or shows a Agg Search tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SEARXNG_URL Self-hosted SearXNG base URLAGG_SEARCH_PORTAL Portal preset ( . , e.g. codex.academic)AGG_SEARCH_PROFILE Domain profile override (general, academic, code, news)Descriptions are as written by the maker.
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with Cursor, with some setup first
You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a Cursor chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Agg Search for Cursor on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "mcpServers": { "agg-search": { "command": "uvx", "args": [ "agg-search", "agg-search-mcp" ], "env": { "EXA_API_KEY": "your-value", "BRAVE_API_KEY": "your-value", "SERPER_API_KEY": "your-value", "MCP_ANYSEARCH_API_KEY": "your-value", "FIRECRAWL_API_KEY": "your-value", "TAVILY_API_KEY": "your-value", "DEEPSEEK_API_KEY": "your-value", "JINA_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Agg Search tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Agg Search settings, EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Agg Search and tell me what you can do for me, then show me one thing✓ If Cursor says it is using Agg Search or shows a Agg Search tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SEARXNG_URL Self-hosted SearXNG base URLAGG_SEARCH_PORTAL Portal preset ( . , e.g. codex.academic)AGG_SEARCH_PROFILE Domain profile override (general, academic, code, news)Descriptions are as written by the maker.
Menu names checked against Cursor’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Works with VS Code, with some setup first
You need a Agg Search key (create it on the maker’s site) · Install Python (uv) on your computer first (one time)
Copy this message into a VS Code chat. The AI checks your computer, tells you which file it will change, and waits for your OK every time.
Please install the MCP server Agg Search for VS Code on this computer, in this order: 1) Check uv with uv --version. If it is missing, tell me to install it from https://docs.astral.sh/uv/getting-started/installation/; do not install it yourself. 2) Use only this config (already checked by PopNx MCP): { "servers": { "agg-search": { "type": "stdio", "command": "uvx", "args": [ "agg-search", "agg-search-mcp" ], "env": { "EXA_API_KEY": "your-value", "BRAVE_API_KEY": "your-value", "SERPER_API_KEY": "your-value", "MCP_ANYSEARCH_API_KEY": "your-value", "FIRECRAWL_API_KEY": "your-value", "TAVILY_API_KEY": "your-value", "DEEPSEEK_API_KEY": "your-value", "JINA_API_KEY": "your-value" } } } } 3) Tell me the full path of the file you will change, or the command you will run, and wait for my OK. 4) For EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY, leave "your-value" in place and tell me to paste the real value myself into the file or the app’s field. Never ask me to type a key in chat. 5) Do what we agreed, then check that the Agg Search tools really show up.This message has no key in it. If a key is needed, the AI will ask you to paste it yourself into the file or the app’s field.
Already installed? Check first · Open Terminal, type this command and press Enter
uv --versionMac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: uv has no click-through installer. Copy the one-line command for your system (macOS or Windows) from uv’s official page into Terminal · no separate Python install needed; uv downloads it when required
When it’s done, close Terminal, open it again and run the same command. You should see a version number: uv --version
Install once; it works for everything that needs uv
Open the maker’s site, sign up and create an API key for the next step. Check the maker’s site for pricing and free plans.
How to get a key is in the maker’s README below
In the Agg Search settings, EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY is empty; add your key and save
Paste the key only into the app’s field, never into a chat or to anyone
Use Agg Search and tell me what you can do for me, then show me one thing✓ If VS Code says it is using Agg Search or shows a Agg Search tool in the answer, you are connected
The command above works without these. Add them only if you want to change something, following the maker’s description.
SEARXNG_URL Self-hosted SearXNG base URLAGG_SEARCH_PORTAL Portal preset ( . , e.g. codex.academic)AGG_SEARCH_PROFILE Domain profile override (general, academic, code, news)Descriptions are as written by the maker.
Menu names checked against VS Code’s help page on Nov 11, 2026 · your screen may differ slightly by app version
Claude Code
claude mcp add --scope user agg-search --env EXA_API_KEY=your-value --env BRAVE_API_KEY=your-value --env SERPER_API_KEY=your-value --env MCP_ANYSEARCH_API_KEY=your-value --env FIRECRAWL_API_KEY=your-value --env TAVILY_API_KEY=your-value --env DEEPSEEK_API_KEY=your-value --env JINA_API_KEY=your-value -- uvx agg-search agg-search-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"agg-search": {
"command": "uvx",
"args": [
"agg-search",
"agg-search-mcp"
],
"env": {
"EXA_API_KEY": "your-value",
"BRAVE_API_KEY": "your-value",
"SERPER_API_KEY": "your-value",
"MCP_ANYSEARCH_API_KEY": "your-value",
"FIRECRAWL_API_KEY": "your-value",
"TAVILY_API_KEY": "your-value",
"DEEPSEEK_API_KEY": "your-value",
"JINA_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"agg-search": {
"command": "uvx",
"args": [
"agg-search",
"agg-search-mcp"
],
"env": {
"EXA_API_KEY": "your-value",
"BRAVE_API_KEY": "your-value",
"SERPER_API_KEY": "your-value",
"MCP_ANYSEARCH_API_KEY": "your-value",
"FIRECRAWL_API_KEY": "your-value",
"TAVILY_API_KEY": "your-value",
"DEEPSEEK_API_KEY": "your-value",
"JINA_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"agg-search": {
"type": "stdio",
"command": "uvx",
"args": [
"agg-search",
"agg-search-mcp"
],
"env": {
"EXA_API_KEY": "your-value",
"BRAVE_API_KEY": "your-value",
"SERPER_API_KEY": "your-value",
"MCP_ANYSEARCH_API_KEY": "your-value",
"FIRECRAWL_API_KEY": "your-value",
"TAVILY_API_KEY": "your-value",
"DEEPSEEK_API_KEY": "your-value",
"JINA_API_KEY": "your-value"
}
}
}
}EXA_API_KEY secret required envBRAVE_API_KEY secret required envSERPER_API_KEY secret required envMCP_ANYSEARCH_API_KEY secret required envFIRECRAWL_API_KEY secret required envTAVILY_API_KEY secret required envDEEPSEEK_API_KEY secret required envJINA_API_KEY secret required envSEARXNG_URL envAGG_SEARCH_PORTAL envAGG_SEARCH_PROFILE envDescriptions are as written by the maker.
These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.
Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 21, 2026
The registry name was verified with the GitHub account TsukimioRinka, which owns the repo
Code last changed yesterday
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked yet
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/tsukimiorinka-agg-search)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
You need to fill in: EXA_API_KEY, BRAVE_API_KEY, SERPER_API_KEY, MCP_ANYSEARCH_API_KEY, FIRECRAWL_API_KEY, TAVILY_API_KEY, DEEPSEEK_API_KEY, JINA_API_KEY
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed yesterday, and the latest version (1.0.0) reached the registry today.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.
In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Keyword research, site audits, rank tracking and AI visibility for your AI agent.
Official Exa MCP for web search, content fetching, and multi-step research.
Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.
Search and read Empryo's documentation. Read-only, no auth, no local access.
cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls
| This one Agg Search | OpenSEO | Exa | Microsoft Learn MCP | Docs | COTAL actions (cotal.ai) | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | Yes | No | No | No | No | No |
| Add with + in Claude | No | Yes | Yes | Yes | No | No |
| Basic checks | 3/3 | 5/5 | 2/4 | 4/4 | 4/4 | 4/4 |
| License | MIT | MIT | MIT | CC-BY-4.0 | NOASSERTION | Apache-2.0 |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
多引擎并行召回 + RRF 融合 + Jina 精排的搜索工具链:CLI + MCP server(stdio/HTTP)+ 分层抓取,宿主机零依赖(纯 Python 标准库)。
A multi-engine search stack for agents: parallel recall across eleven engines (three of them keyless domain sources), RRF fusion, listwise reranking, domain profiles, a local feedback loop, plus a tiered fetcher. Ships as a CLI and an MCP server — stdio, or streamable HTTP — with standard library only on the host.
*真实一次运行的输出:7 个引擎返回结果,DeepSeek 因余额不足进入冷却、被跳过;空结果不阻塞其余引擎。*
同类项目不少,但多数是「多引擎 + 简单合并」或「零 key 依赖单一索引」。这个项目的差异在六件事:
/v1/tools/search 自带 rerank_score,/v1/tools/fetch 服务端取页直接给 Markdown,省掉容器。2025-06-18(含 outputSchema/structuredContent、tool annotations、版本协商)、stdio 与 streamable HTTP 两种传输、按调用计的硬超时与 notifications/cancelled、13 家客户端的配置生成器。--profile academic|code|news 换的是引擎组合、RRF 权重、默认时效与摘要长度(数据驱动,不改代码);search 记录哪些引擎召回了结果、fetch 记录哪些被真正读过,agg-search-tune 据此调整引擎权重,越用越贴合本机习惯。flowchart LR
subgraph clients[Agent clients] CC[Claude Code] CX[Codex] CU[Cursor] VS[VS Code] OC[OpenCode] end CC & CX & CU & VS & OC -->|stdio JSON-RPC| M[agg-search-mcp] CC & CU & VS -->|streamable HTTP| H[agg-search-http] M --> Q H --> Q[query expansion local ollama] Q --> A[exa] Q --> B[brave] Q --> C[serper] Q --> D[deepseek] Q --> E[firecrawl] Q --> F[anysearch] Q --> G[tavily] Q --> Hh[searxng] Q --> OA[openalex] Q --> HN[hn] Q --> ST[stack] A & B & C & D & E & F & G & Hh & OA & HN & ST --> R[RRF fusion profile weights × learned multipliers] R --> J[jina rerank v3.5 fallback v3 → v2] J --> O[top N results
# PyPI(0.2.0 起)
uvx --from agg-search agg-search-mcp # 不落盘,直接跑
uv tool install agg-search
源码方式:
git clone https://github.com/TsukimioRinka/agg-search
cd agg-search uv pip install -e .
PYTHONPATH=src python3 -m agg_search.search "query"
| 入口 | 说明 |
|---|---|
| docs/catalog.md | 13 家 Agent × 4 个领域画像的完整入口表 |
| catalog.json | 同一份数据的机器可读版本(给脚本/目录站用) |
| docs/portals.md | 52 个 agent × domain 门户隔离规格(工具子集/顺序、prompt、依赖与降级) |
| portals.json | 机器可读门户注册表(与 catalog.json 严格同步) |
| Cursor / VS Code | 表里是一键深链,直接带上 AGG_SEARCH_PORTAL / AGG_SEARCH_PROFILE |
| Claude Code / Codex | 一条 mcp add 命令,含 --env |
| 其他客户端 | agg-search-install --portal . --write |
| 实测记录 | docs/agent-tests.md:6 个 CLI 客户端的门户隔离实测 |
非 general 画像注册为独立的 server 名(agg-search-academic、agg-search-code、agg-search-news),可以和默认的 agg-search 并存。
agg-search-install --portals --markdown # 重新生成 docs/portals.md
agg-search-install --portals # 打印 portals.json agg-search-install --catalog --markdown # 重新生成 docs/catalog.md agg-search-install --catalog # 打印 catalog.json
# 搜索
agg-search "rust async runtime comparison" --top-n 10 --recency month
agg-search "speculative decoding" --include-domains arxiv.org,.edu \ --exclude-domains reddit.com
agg-search "MCP server examples" --json
agg-search "vector database tradeoffs" --expand 3
agg-search "what changed in Python 3.13" --answer
agg-search "breaking news" --fast --budget-secs 20
agg-search --show-config agg-search --help
crawl-fetch --url https://example.com/post --tier auto --out md
密钥只从环境变量读(也兼容 ~/.config/agent-env、~/.config/ai-keys.env 的 KEY= 行)。缺失的引擎会被跳过,不会让整次搜索失败。常用默认值可用 AGG_SEARCH_ENGINES、AGG_SEARCH_TOP_N、AGG_SEARCH_PER_ENGINE、AGG_SEARCH_SNIPPET_CHARS、AGG_SEARCH_FAST、AGG_SEARCH_NO_JINA、AGG_SEARCH_PROFILE、AGG_SEARCH_NO_LEARN 覆盖,命令行显式传参优先。完整变量表见 docs/environment.md。
暴露工具按门户隔离(默认 search + fetch;academic 门户按 search -> fetch -> answer 暴露三件套):
| 工具 | 主要参数 | 说明 |
|---|---|---|
search | query、top_n、recency、engines、portal、profile、include_domains、exclude_domains、snippet_chars、expand、answer、answer_fetch、fast、budget_secs、engine_timeout、no_jina | 并行召回 + 内容去重 + 权威先验 RRF + 精排;返回文本内容 + structuredContent |
fetch | urls、tier、out、text_limit | 分层抓取正文(SSRF 守卫由服务端环境变量控制);每 URL 一条结果 |
answer | query、sources、urls、mode、portal、profile | 仅在 academic 门户暴露;读取摘要或抓取全文,按 Agent 回退顺序合成带引用回答 |
协议行为:
2025-06-18 / 2025-03-26 / 2024-11-05,按客户端请求回选支持的版本。title、annotations(readOnlyHint、openWorldHint)和 outputSchema;支持结构化输出的客户端直接拿 structuredContent,老客户端仍拿文本。notifications/cancelled 同样会中断。ping/tools/list 不会被慢引擎卡住。search 在 MCP 下默认 fast=true(有限的召回预算),fast=false 才等全部引擎。agg-search-install --list # 支持 13 家客户端
agg-search-install -c claude-code # 打印 claude mcp add 命令 agg-search-install -c cursor --write # 合并进 ~/.cursor/mcp.json(自动备份) agg-search-install -c vscode --scope project # 写 .vscode/mcp.json agg-search-install -c cursor --check # 校验文件、条目与运行时是否就绪
逐客户端的路径、JSON/TOML/YAML 片段与 GUI 环境变量陷阱见 docs/adapters.md。
agg-search-http --host 127.0.0.1 --port 8765 --path /mcp
多个客户端共用一个进程(共享缓存与冷却),默认只绑回环并校验 Host/Origin(防 DNS rebinding 与浏览器跨站请求),端点不带认证——对外必须先套反向代理。协议细节与 nginx 示例见 docs/http.md。
agg-search "speculative decoding" --profile academic # openalex 优先,摘要 500 字,top 15
agg-search "sqlite wal corrupt" --profile code # stack 优先,摘要 600 字 agg-search "release notes" --profile news --top-n 5 # 默认 recency=day agg-search --list-profiles
agg-search-install -c cursor --profile code --write # 把某个客户端钉在 code 画像上
同一套数据也通过 MCP 暴露:工具参数 profile,或环境变量 AGG_SEARCH_PROFILE。优先级 flag > env > profile > 内置默认;openalex / hn / stack 三个新引擎全部免 key,装好就能用。
search 记录每个结果由哪些引擎召回,fetch 成功读到其中某个 URL 时记一次「被使用」。 agg-search-tune 把 surfaced/used 折算成 0.5–2.0 的引擎权重乘数(样本少于 30 时保持 1.0), 之后所有搜索自动叠加,并进入缓存键——调权重不会命中旧结果。默认开启,--no-learn 或 AGG_SEARCH_NO_LEARN=1 关闭。
agg-search-tune --show # 反馈表 + 当前乘数
agg-search-tune # 写入 ~/.config/agg-search/weights.json
只存哈希与计数,不存查询词、页面正文或原始 URL。机制与公式见 docs/profiles.md。
只列能核实的能力,语言一列仅在仓库自述里明确时填写:
| 项目 | 栈 | 它强在哪 | 与本项目的差别 |
|---|---|---|---|
| search-cli | Rust | 13 个 provider,单一二进制 | 本项目免编译;多容器抓取阶梯与 DeepSeek Fetch 是一等路径 |
| web-search-mcp | TypeScript | 注入防御( 包裹 + 隐藏字符剥离)、PDF/RSS/YouTube 抽取、本地语义重排、Recall@5 / MRR@10 评测、MCP resources/prompts | 它的内容抽取与提示注入防护比本项目完整;本项目的差异在 8 引擎并行 + RRF→Jina listwise、DeepSeek Search/Fetch、RAG-Fusion 与容器阶梯。SSRF 防护两边都有,本项目覆盖到抓取前置校验(见 docs/fetching.md) |
| argo | — | 300+ 来源、18 语言、MCP/CLI | 本项目只做通用网页检索,覆盖面窄;差异在排序链路与成本控制更细 |
| Tavily MCP | TypeScript | 托管远端端点、search/extract/map/crawl 四件套、DEFAULT_PARAMETERS | 本项目可自带引擎、离线缓存与精排链,不绑定单一供应商 |
| Brave MCP | TypeScript | 官方索引,HTTP 传输带 Origin/Host 白名单 | 本项目多引擎融合;传输层安全策略参考了它的做法 |
| Exa MCP | TypeScript | 托管端点 + OAuth、dynamic highlights | 本项目无托管依赖,密钥和缓存都在本机 |
uv venv && uv pip install -e .
python3 -m unittest discover -s tests -v
220+ 个离线测试:门户隔离与降级、内容去重、权威先验、域名过滤、RRF、冷却分类、缓存键、SSRF 判定、安装器、MCP 协议面与 stdio/HTTP 端到端(不发起网络请求、不消耗额度)。CI 覆盖 Python 3.10–3.13 + ruff。
.env.example 只有空占位。--show-config 只输出布尔值。--allow-private 显式放开);响应体上限 4 MiB。Host/Origin 白名单,无认证时不得裸奔到公网。| 文档 | 内容 |
|---|---|
| docs/install.md | 安装方式、环境变量全表、冒烟测试 |
| docs/adapters.md | 13 家客户端的接入配置 |
| docs/http.md | HTTP 传输、安全模型、反向代理 |
| docs/profiles.md | 领域画像、每 agent 策略、反馈回路与调参 |
| docs/portals.md | 52 个 agent × domain 门户规格、工具顺序与降级路径 |
| docs/benchmarks.md | 5 项增强机制的对照评测(18 领域 + 10 通用查询)与取舍依据 |
| docs/agent-tests.md | 6 个 CLI 客户端的门户隔离实测与清理记录 |
| docs/handoff.md | 交接:本机路径、凭据位置、逐层验证与发版流程 |
| docs/fetching.md | 分层抓取的梯子与容器 |
| docs/reranking.md | RRF 与 Jina 精排、参数扫描 |
| docs/environment.md | 环境变量与计费说明 |
MIT