---

name: volcengine-askecho-search description: 火山方舟联网搜索 MCP（askecho-search-infinity）—— 国内可用的真·联网搜索 API，直调 feedcoopapi 端点。按量计费，Key 从 OpenClaw 配置共享。 version: 1.0.0 author: Hermes Agent license: MIT metadata: hermes: tags: [MCP, search, volcengine, askecho, network-research] related_skills: [native-mcp, mcporter]

---

火山方舟联网搜索 MCP（askecho-search-infinity）

When to Use

用户要求"联网搜索 / 网络搜索 / 真实搜索"时优先用这个，不要再 curl。

特别适合： - 国内环境（Google / Brave / DuckDuckGo HTML / Searx 公共实例全墙或反爬） - 调研某软件/插件/产品的最新版本、社区经验、最佳实践 - 验证训练知识的真实性（不能再用"curl GitHub raw 冒充网络搜索"） - 替代手工 curl qiita.com/search + curl booth.pm + curl bilibili.com 的拼凑

不适合： - 拉某个具体 URL 的 raw 内容 → 用 terminal curl 或 browser_navigate - GitHub 源码查找 → 直接 curl raw.githubusercontent.com - 站内精确文档查阅 → browser_navigate + browser_snapshot

Prerequisites

1. API Key — 共享 OpenClaw 配置中的 Key（OK9x...9MHa），已在 Hermes config.yaml mcp_servers.askecho-search 配好，无需额外申请
2. 真实端点 — https://open.feedcoopapi.com/search_api/web_search，Header: Authorization: Bearer {KEY} + X-Traffic-Tag: ark_mcp_server_web_search
3. 系统装了 uvx（已在 /root/.local/bin/uvx） Bearer {KEY}+X-Traffic-Tag: ark_mcp_server_web_search`
4. 系统装了 uvx（已在 /root/.local/bin/uvx）## Hermes 接入（native-mcp）

config.yaml 中 mcp_servers 已有：

mcp_servers:
  askecho-search:
    command: uvx
    args:
      - "--from"
      - "git+https://github.com/volcengine/mcp-server#subdirectory=server/mcp_server_askecho_search_infinity"
      - "mcp-server-askecho-search-infinity"
    env:
      ASK_ECHO_SEARCH_INFINITY_API_KEY: <KEY>
    timeout: 60
    connect_timeout: 30

改完 config.yaml 必须重启 Hermes 主 agent 进程才能加载新 MCP（不是 gateway，是 friend profile 的 agent 进程）。重启后工具会以 mcp_askecho_search_* 前缀注入。

验证是否加载成功

重启 Hermes 后，看 agent 启动日志里有没有：

[MCP] Connected to server 'askecho-search', discovered N tools

或在对话里看可用工具列表前缀是否有 mcp_askecho_search_。

备用：mcporter / 临时调用

如果不想重启 Hermes，可用 mcporter 临时跑（参见 mcporter skill）：

mcporter call askecho-search search --args '{"query":"lilToon 暗い 修正"}'

配额管理

• 在 Agent Plan 控制台 查"使用配置-配置Harness"区域看剩余额度
• 免费额度用尽后可开通"超额付费调用"
• 每月 1 日额度清零刷新，跨月不累加
• 免费额度优先消耗，超额才走付费

关键坑

坑 1：以为 config 改完就生效

config.yaml 加完 MCP 配置 必须重启 Hermes 主 agent 进程，热加载不支持。gateway restart 不够，要重启 friend profile 的 python 进程。

坑 2：误以为没 Key

一台机器只允许创建 2 个 Key。先去控制台看现有 Key 列表，不要随便点"创建"导致挤爆名额。

坑 3：和"联网内容插件"混淆

方舟还有个"联网内容插件"是模型层挂载的，和这里说的搜索 API 完全不同。我们用的是 MCP/Skill 形式的搜索 API（mcp-server-askecho-search-infinity）。 联网内容插件"是模型层挂载的，和这里说的搜索 API 完全不同。我们用的是 MCP/Skill 形式的搜索 API（mcp-server-askecho-search-infinity）。### 坑 4：API Key 明文 当前 Key 明文存在 config.yaml 第 311 行。建议改成 env 变量引用（如 ${ASKECHO_KEY}）+ Key 放 ~/.hermes/profiles/friend/.env。

坑 5：套餐到期后赠送额度回收

Agent Plan 套餐到期后，下单附赠的免费搜索额度会回收。续费才能保留。

国内搜索环境备忘（2026-06 实测）

服务	状态	备注
Google / Brave / Bing 国际	❌ 墙	直接 curl 不通（exit 000）
Bing CN	⚠️ 出口劫持	只返回中文站结果，质量差
DuckDuckGo HTML	❌ 反爬	返回空
Searx 公共实例	❌	多个实例 0 字节
docs.vrcd.org.cn 等中文 wiki	✅	curl 可抓
Qiita / Booth / B站	✅	curl 可抓，可做站内搜
GitHub raw	✅	适合源码硬事实，不算网络搜索
方舟 askecho-search	✅	国内可用的真·联网搜索

信息来源纪律（来自硬纪律 §8）

• curl GitHub raw ≠ 网络搜索 → 这只是源码硬事实
• mcp_askecho_search_* = 真·网络搜索 → 真去搜引擎抓内容
• 区分"训练知识猜测" vs "源码硬事实" vs "真实搜索"，不许混淆
• 写记忆/回复禁用"全部核实/100%准确"糊弄；未真实搜索过的推荐值必须标"未核实"

References

• 文档：火山方舟联网搜索 Beta 页（最近更新 2026.05.07）
• 套餐：https://www.volcengine.com/docs/82379/2366394
• 控制台：https://console.volcengine.com/ark/region:ark+cn-beijing/openManagement
• 源码：https://github.com/volcengine/mcp-server/tree/main/server/mcp_server_askecho_search_infinity