chukonu-web-search

Chukonu Search + Research

通过 Chukonu remote MCP 调用公开的 search 和 research 工具。无需本地二进制、API key 或静态 token；不要调用内部工具、上游服务或内部端口。法律法规检索是服务内部接入的 FY MCP provider，客户端不要单独配置它、传入其凭据或尝试调用其工具。

一次性接入

使用 https://search.houdutech.cn/web/mcp/ streamable-http 端点。该端点通过标准 OAuth 2.0 保护，采用动态客户端注册、授权码、PKCE(S256) 和 refresh token，scope 为 search:read。让 MCP host 自动发现并注册，不要手工填写 client ID 或 client secret。

OpenClaw：

openclaw mcp add chukonu-web-search \
  --url https://search.houdutech.cn/web/mcp/ \
  --transport streamable-http \
  --auth oauth
openclaw mcp login chukonu-web-search

Claude Code：

claude mcp add chukonu-web-search https://search.houdutech.cn/web/mcp/ \
  --scope user --transport http
  
Codex：

```bash
codex mcp add chukonu-web-search --url https://search.houdutech.cn/web/mcp/
odex mcp login chukonu-web-search
codex mcp list

然后在会话中：/mcp → chukonu-web-search → Authenticate

不要为该服务器配置静态 `Authorization` 头或 `CHUKONU_SEARCH_API_TOKEN`。静态 Authorization 头会使 host 禁用 OAuth 回退，并可能导致 `401 invalid_token`。把 OAuth token 完全交给 host 保管，不要在日志、回答、示例或错误信息中泄露。

## 选择工具与来源

- 用 `search` 处理秒级发现、法规定位和获取后续研究所需的 `research_seed.search_id`。
- 用 `research` 处理关键主张核验、反证、跨来源冲突、全文定位或证据覆盖评估。必须先 `search`，再用返回的 `search_id` 启动任务。
- `source_types` 只接受 `web`、`academic`、`patent` 和 `legal`。省略时服务自动路由。、

## `search`

### 请求

最小调用：

```json
{
  "query": "固态电池硫化物电解质近五年的关键路线"
}

需要约束来源或过滤范围时：

{
  "query": "固态电池硫化物电解质近五年的关键路线",
  "limit": 10,
  "source_types": ["web", "academic", "patent"],
  "filters": {
    "published_from": "2021-01-01",
    "published_to": "2026-07-17",
    "languages": ["zh", "en"],
    "jurisdictions": ["CN", "US", "EP", "WO"]
  }
}

遵守以下约束：

• query 必填；保持查询简洁、具体。
• limit 为最终全局返回数，范围是 1–20。
• source_types 仅接受 web、academic、patent。省略时让服务自动路由；传入后只检索指定类型。
• filters 支持 published_from、published_to、languages、jurisdictions。
• 不要发送请求级模型、重排、PDF 或 trust 开关。未知字段会被拒绝。

解读搜索结果

按以下顺序检查响应：

1. 检查 failures[]，确认是否有来源或阶段失败。
2. 检查 result_set.counts_by_stage 中 web、academic、patent、legal 的 recalled/ranked/assembled/selected 计数，定位候选丢失阶段。
3. 检查 retrieval_assessment.status 与 retrieval_assessment.gaps[]，判断证据是否足够。
4. 检查 query.filter_execution，确认每项过滤器实际 applied、unsupported 或 not_applicable 的状态。
5. 对法律证据读取 type: "legal"、passage、legal.law_type、legal.status、legal.department、legal.directory 与 legal.item。引用时保留法规标题和条号。
6. 法律证据可能没有公开 URL，且 access.is_open 为 false。不要臆造官方链接、发布日期、法规效力或全文定位；原文被截断时遵守 diagnostics 中的限制。
7. 仅用 evidence[].scores.relevance 排序，不将其视为可信度或法律效力判断。

status 只表示搜索执行是否完整，不代表证据充分性。research_seed.search_id 指向服务端保存的不可变 evidence 与检索边界快照；不要构造、修改或回传该快照。

research

research 是持久化研究任务的统一生命周期工具，支持 start、get、feedback 和 cancel。

启动任务

从搜索响应取得 research_seed.search_id 后调用：

{
  "operation": "start",
  "search_id": "srch_...",
  "idempotency_key": "agent-run-20260811-001",
  "profile": "technology_validation",
  "depth": "standard",
  "objective": {
    "question": "硫化物电解质的关键路线是什么，哪些已形成专利布局？",
    "claims": [
      {
        "text": "硫化物电解质已形成较完整的专利布局",
        "importance": "key"
      }
    ],
    "required_features": ["离子电导率", "界面稳定性", "制备方法"]
  }
}

• 必须提供 search_id 和全局 idempotency_key。为同一个逻辑请求的重试复用同一个 key；只有请求实质改变时才换 key。
• 选择 profile：literature_review、technology_validation（默认）、prior_art_landscape 或 technology_landscape；选择 depth：quick、standard 或 deep。
• 把问题写入 objective.question，已知待核验陈述写入 objective.claims，必须覆盖的维度写入 objective.required_features。
• 仅在要收紧预设上限时提供 budget；不要用它扩大预设预算。

读取、补充与取消

读取任务：

{
  "operation": "get",
  "research_id": "rsch_...",
  "detail": "full"
}

• 当 state 为 queued 或 running 时，等待响应中的 retry_after_ms 再读取；不要高频轮询。
• 仅在 needs_input 时提交 feedback。先读取最新任务，再以当前 task_revision 提交真实的 answers 或 note；不要替用户虚构答案。
• 取消任务时使用最新的 task_revision。终态包括 completed、partial、needs_input、failed 与 cancelled。
• state="completed" 只表示流程正常停止。用 dossier.assessment.overall 判断结论充分性，并从 finding 的 evidence ID 解引用 dossier.evidence_index；同时检查 dossier.coverage.gaps 和顶层 stop。

作答规则

• 让每个关键结论对应具体 evidence，并保留 finding、evidence 和 locator 的关系。区分搜索片段、法规条文、PDF 原文和研究结论。
• 法律问题先说明适用法域、检索时点、法条状态和证据缺口；将法条内容、事实适用和结论明确分开。对于个案、争议或跨法域问题，提示用户咨询合格的法律专业人士。
• 学术结论优先使用可定位的原始论文；专利结论优先使用专利文献，并区分申请、公开、授权和未知状态。
• 对时效性问题检查证据日期、legal.status 和 filter_execution。日期陈旧、状态待核实、过滤未执行或证据缺少公开链接时，明确披露限制。
• 当 retrieval_assessment.status 为 limited，有实质 failures[]，或法律/研究证据为 partial、insufficient、conflicted、needs_expert_review 时，不要给出无保留的确定性结论。
• 不要生成或声称接口提供单一 trust_score，不要臆造来源、法规元数据、引文、申请人、发明人、日期、许可证或 URL。

错误处理

• 401 invalid_token 或未授权：重新执行 openclaw mcp login chukonu-web-search，或在 Claude Code 中通过 /mcp → chukonu-web-search → Authenticate 重新完成 OAuth；同时检查并移除误配的静态 Authorization 头。
• search 参数被拒绝：移除未知字段，确认 limit、source_types、日期和 legal_status 的格式。
• research 返回 needs_input：读取 input_request，向用户取得答案后用最新 revision 提交。返回 failed、partial 或 cancelled：读取 failures[]、stop 和 coverage gaps，并说明已完成部分与限制。