Skip to main content

How to use argo

Integrate Argo multilingual search

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

argo

— source: plugin_wiki.wiki_content

Install & verify

dsh plugin --profile web add github:taxueseek/argo

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • 证据闭环(v2.8.0 新增):搜索输出自带证据门控——高后果问题(金融/医疗/法律)标 fetch_required,每条结果标 fetch_suggested;--verify 一键核验正文并回填「核实后证据分」,核实过的链接自动记住,下次搜索直接显示已核实
  • 求职搜索 v3(v2.8.0 升级):argo job 结构化字段 + 增量监控 + 指纹去重,新增 Ashby ATS 免 Key 后端与北京高校就业源
  • 天气双源并行(v2.8.0 升级):wttr.in + Open-Meteo 双源,地理编码 + 空气质量,问天气不落空
  • 通用搜索增强(v2.8.0 新增):Parallel 搜索(长文摘录、多路召回)与 You.com(网页+新闻合并、时效动态化),无 Key 优雅降级
  • 约 150+ 个搜索源、70+ 业务域:通用网页 + 金融 / 宏观 / 影视 / 体育 / 地理 / 组织 / 媒体 / 化学 / 学术 / 代码等(真源:config.yaml)

— source: plugin_wiki.readme_en (fallback readme_raw)

FAQ

What can I see in DSH after installation?

After installation, restart dsh web and the model side will have 10 additional capabilities starting with mcp__argo__, covering unified search, local file search, deep research, credibility assessment, intent disambiguation, page scraping, site crawling, page screenshots, PDF extraction, and social platform search.

Do I need to configure an API Key to use it?

No, it's not required. Argo has built-in many free and local engines; when no Key is configured, it automatically uses the zero-cost path; after configuring keys like Tavily/Bocha/Metaso, some engine results will be of higher quality.

Does it depend on Python?

Yes. bin/argo.js starts with Node, but the actual logic runs in the Python process scripts/mcp_server.py, so the machine needs Python 3.10+ with PyYAML installed. When the system has macOS's built-in 3.9, you need to use ARGO_PYTHON to point to a 3.10+ interpreter.

I want to use local source code instead of pulling from GitHub, how do I do that?

In the profile's cordis.patch.yml user layer, override the default configuration using the same id (mcp-argo), change the command from npx to python3 and point it to the local scripts/mcp_server.py.

Where is data stored? How to clear cache?

Query cache is written to ~/.cache/unified-search/cache.db (SQLite), TTL is tiered by domain (finance 5 minutes, research 2-24 hours). Deleting that file will clear the cache.

Why does social platform search sometimes return empty?

hackernews/zhihu/bilibili can be used without keys, but twitter/reddit/weibo/xiaohongshu require external login status or third-party API, and will fall back to empty when not configured. Social results don't enter the public cache to avoid polluting main search.

Are argo_fetch and argo_pdf the same thing?

No, they are different. argo_fetch scrapes HTML pages (HTTP first, upgrades to browser when anti-scraping is detected), and will directly error when encountering PDF Content-Type; for PDFs, use argo_pdf which uses pdfplumber or PyMuPDF.

Which platforms does this plugin support?

package.json os field declares darwin and linux; on Windows, the npx entry falls back to python command. The Python MCP core itself is cross-platform, but optional capabilities like Chrome screenshots depend on a graphical environment.

— source: plugin_wiki.faq_json

Compatibility

  • DSH: 未声明
  • Node: >=18

— source: plugin_wiki.compatibility_json

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule