baidu baike search

核心用法

Baidu Baike Data 是一个面向中文场景的百科知识查询技能，通过调用百度官方AppBuilder API，为用户提供标准化、结构化的百科词条解释。该技能采用双API架构设计：

• LemmaList API：用于模糊匹配，根据词条名称返回候选列表，包含is_default标记的主词条标识
• LemmaContent API：用于精准查询，支持通过词条ID或词条名称获取完整释义内容

推荐工作流为先使用LemmaList确定准确词条ID，再用LemmaContent获取详情，以避免同义词歧义问题。技能内置Shell脚本封装层（scripts/baidu_baike.sh），提供search、search_by_id、list_by_title三种调用模式。

显著优点

• 中文权威信源：直接对接百度 Baike，覆盖数千万中文词条，在中文实体知识领域具有较高完整性
• 结构化输出：返回字段包含lemma_id、desc、url、summary、videos、relations等，便于下游解析
• 关联知识挖掘：对于知名人物或事件，自动返回相关人物/事物关联图谱
• 低使用门槛：仅需配置单一环境变量BAIDU_API_KEY，依赖仅为标准curl

潜在局限

• 仅限客观实体：明确不支持主观查询、开放式问题或创造性内容生成
• 中文场景绑定：词库与知识架构以中文为核心，英文或其他语言实体覆盖有限
• API依赖风险：需百度AppBuilder平台持续运营，存在服务可用性外部依赖
• 实时性限制：百科内容更新周期非实时，新兴热点或最新事件可能存在滞后

适合人群

• 需要为AI Agent注入中文常识知识的开发者
• 构建问答系统、知识库检索的RAG场景用户
• 对中文历史人物、地理名称、科技概念有精准释义需求的业务场景

常规风险

| 风险类型 | 说明 |

|---------|------|

| API密钥泄露 | `BAIDU_API_KEY`需妥善保管，硬编码或日志泄露可能导致配额滥用 |

| 内容准确性 | 百科内容由众包编辑维护，存在事实性错误或偏见可能，关键场景建议交叉验证 |

| 合规边界 | 部分政治、历史敏感词条可能返回审查后内容，或存在访问限制 |

核心用法

Baidu Baike Data 是一个面向 OpenClaw Agent 的轻量级知识查询工具，通过调用百度官方 API 实现词条检索功能。Skill 提供两条核心路径：

1. LemmaList API (/v2/baike/lemma/get_list_by_title) — 根据词条名称查询同名词条列表，返回字段中的 is_default 标识主词条
2. LemmaContent API (/v2/baike/lemma/get_content) — 根据词条 ID 或名称查询详细释义，推荐优先使用词条 ID 以确保准确性

用户可通过封装脚本 scripts/baidu_baike.sh 快速调用，支持三种模式：按名称搜索、按 ID 搜索、先列表后精确定位。典型工作流为：提取用户 query 中的客观名词 → 调用 API → 获取结构化结果（含词条摘要、关联人物/事物、视频、知识体系等）→ 返回给 Agent 用于后续推理或回答生成。

显著优点

• 权威数据源：直接对接百度 Baike 内容库，中文百科覆盖度与更新频率领先
• 零依赖封装：仅依赖系统 curl，无第三方语言包，部署极轻量（62 行代码 / 2 个文件）
• 安全合规：API Key 通过环境变量 BAIDU_API_KEY 注入，无硬编码风险；全链路 HTTPS (TLS 1.2+)
• 隐私友好：无静默数据收集，符合 GDPR 数据最小化原则
• 结构化输出：返回 JSON 格式，含 lemma_id、desc、relations 等字段，便于下游解析

潜在局限

• 输入验证薄弱：未对用户输入进行 URL 编码，特殊字符（如 &、%、空格）可能导致请求失败或解析异常
• 外部命令依赖：完全依赖系统 curl，跨平台版本差异或恶意替换可能引入不可控风险
• 来源可信度待提升：维护者为个人/社区身份（trust_level: T3），license 未声明，长期维护稳定性存疑
• 无超时与重试机制：网络异常时可能长时间挂起，影响 Agent 响应时效
• 中文为主：词条库以中文内容为核心，英文或其他语种实体覆盖有限

适合人群

• 需要为 Agent 快速接入中文百科知识能力的开发者
• 构建事实核验、概念解释、人物/事件背景补充类应用的团队
• 已持有百度 AppBuilder API Key 的企业或个人用户
• 对部署体积敏感、追求极简依赖的边缘计算场景

常规风险

| 风险点 | 等级 | 说明 |

|--------|------|------|

| 输入注入/请求异常 | 中 | 缺乏 URL 编码，特殊字符可能导致 API 调用失败或意外行为 |

| 供应链攻击 | 低 | 依赖系统 curl，若被替换为恶意版本存在命令注入风险 |

| API Key 泄露 | 低 | 需用户自行保管环境变量，Skill 本身无泄露渠道 |

| 数据准确性 | 低 | 依赖百度 Baike 内容质量，存在过时或争议性表述可能 |

| 服务可用性 | 低 | 绑定百度官方 API，受百度服务 SLA 及网络可达性约束 |

建议生产使用前：
1. 按推荐方案添加 URL 编码与输入白名单校验
2. 为 curl 设置 --max-time 超时参数
3. 对 API 响应增加 HTTP 状态码检查与降级逻辑