web-search-fallback

Web Search Fallback — 零 MCP 额度的本地搜索/阅读

当 MCP web_search / webReader 工具返回 429 限流错误（MCP error -429 / Weekly/Monthly Limit Exhausted）时，立即切换到本 skill 的本地方案，不要重试 MCP。

也适用于：用户主动要求搜论文、搜 GitHub、读网页，且不想消耗 MCP 额度时。

---

路由决策表

用户意图	路由	工具
搜学术论文	Route 1: arXiv API	curl + python XML 解析
搜 GitHub 仓库	Route 2: GitHub API	gh search repos 或 curl REST API
论文引用/关联图谱	Route 3: Semantic Scholar	curl JSON API
读特定 URL 内容	Route 4: 直接 curl 抓取	curl -sL + 文本提取
读知乎专栏文章	Route 4b: 知乎 / Jina Reader	curl https://r.jina.ai/<url>
通用网络搜索	Route 5: DuckDuckGo HTML	curl + grep（兜底，质量有限）

Windows 注意: 用 python 而非 python3（Windows App Execution Alias 会拦截 python3）。

---

Route 1: arXiv API（学术论文搜索）

基础搜索

curl -sL --max-time 25 "http://export.arxiv.org/api/query?search_query=all:KEYWORD1+AND+all:KEYWORD2&start=0&max_results=10&sortBy=submittedDate&sortOrder=descending" | python -c "
import sys,xml.etree.ElementTree as ET
ns={'a':'http://www.w3.org/2005/Atom'}
root=ET.parse(sys.stdin).getroot()
for e in root.findall('a:entry',ns):
    t=e.find('a:title',ns).text.strip().replace('\n',' ')
    d=e.find('a:published',ns).text[:10]
    aid=e.find('a:id',ns).text.split('/')[-1]
    s=e.find('a:summary',ns).text.strip().replace('\n',' ')[:200]
    print(f'{d} | {aid} | {t}')
    print(f'  {s}...')
    print()
"

搜索语法

• all:keyword — 全文搜索
• ti:keyword — 仅标题
• au:keyword — 仅作者
• 布尔: +AND+, +OR+, +AND+NOT+
• 精确短语: %22reward+design%22（URL 编码的引号）
• 排序: sortBy=submittedDate|relevance|lastUpdatedDate & sortOrder=ascending|descending

示例：搜 reward design + LLM

curl -sL --max-time 25 "http://export.arxiv.org/api/query?search_query=all:%22reward+design%22+AND+all:%22large+language+model%22&max_results=12&sortBy=submittedDate&sortOrder=descending"

按 arxiv ID 取全文摘要

curl -sL --max-time 25 "http://export.arxiv.org/api/query?id_list=2310.12931" | python -c "
import sys,xml.etree.ElementTree as ET
ns={'a':'http://www.w3.org/2005/Atom'}
root=ET.parse(sys.stdin).getroot()
e=root.find('a:entry',ns)
print(e.find('a:title',ns).text.strip())
print(e.find('a:summary',ns).text.strip())
"