用途:解决智能体模型后端无法执行服务器端网页搜索的问题。中转或转售商代理 Claude/Codex 时,Anthropic 的 web_search、web_fetch 与 OpenAI Responses API 的 web_search 属服务器工具,代理方云端往往无法执行,返回空结果而非报错,模型因此自信地声称查不到内容。本技能将该问题显式化并修复,它本身不是搜索引擎,验证成功的标志是智能体会话真的调用了可用工具。
主要能力:1) 在本机诊断,运行 python3 <skill>/scripts/diagnose.py,读取 ANTHROPIC_BASE_URL/AUTH_TOKEN/MODEL 或经 --api openai 使用 OPENAI_ 变量,也可用 --url --key --model;退出码 0 无需修复、1 至少一个工具失效、2 无法判定,支持 --json。这些值常在客户端配置文件中,如 ~/.claude/settings.json 的 env 块、~/.codex/config.toml 与 auth.json,勿打印密钥。脚本仅用标准库,可在 macOS 自带 3.9 上运行。2) 移除已被证实失效的工具,勿移除正常工具。Claude Code 在 ~/.claude/settings.json 的 permissions.deny 加 WebSearch、WebFetch(注意客户端拼写,API 拼写不匹配任何工具);Codex 在 config.toml 顶部、首个 [table] 前写 web_search = "disabled"。修改须合并而非替换,并回读文件。3) 安装客户端可执行工具(如 MCP server),因为后端只看到普通函数调用;先确认该包是否走本地进程或 shell,若仍调用内置 web_search/web_fetch 则无效。参考 references/backends.md 选择,优先级:无需注册、无需本地安装、用户所在环境可达、以用户提问语言返回结果、结果质量。桌面聊天界面不在支持范围。
限制:不直接回答查询;需可用 python3(macOS 首次调用会弹安装对话框);探测超时过长会把健康端点误判为失效;Codex 的 OpenAI 探测需 --openai-model;claude mcp add 应显式指定 --scope;Codex 不要用 codex mcp add 注册托管服务器。具体替代工具名单、费用与平台支持资料中未完整提供。