Tanso 最新版

在构建面向中文市场的 AI 智能体（Agent）或自动化工作流时，获取高质量、结构化的中文网络数据往往是一个痛点。传统的网页抓取不仅效率低下，还容易触发反爬机制。Tanso 是一个基于 Go 语言开发的命令行工具，通过聚合博查（Bocha）、火山引擎 Ark 和知乎等主流中文搜索引擎的 API，为开发者和 AI Agent 提供稳定、标准化且无副作用的中文互联网信号检索服务。

核心亮点：结构化输出与 Agent 原生支持

1. 多源聚合，一键检索

Tanso 整合了三大核心数据源，覆盖不同的搜索场景：

• 博查 (Bocha)：提供通用的网页搜索能力。
• 火山引擎 Ark：基于豆包大模型的深度问答与网页解析。
• 知乎 (Zhihu)：支持站内搜索、全局网页搜索及热榜获取，适合挖掘深度讨论和趋势话题。

2. 标准化 JSON 输出，自动化友好

不同于传统 CLI 工具仅输出人类可读的文本，Tanso 默认提供稳定的 JSON 信封结构。包含查询元数据、结果列表、来源状态及错误信息。这种设计使其能无缝集成到 CI/CD 流水线、脚本或 AI Agent 的上下文构建中，无需复杂的正则解析。

3. 内置 Agent Skills，即插即用

Tanso 遵循 Agent Skills 开放标准，打包了完整的操作 SOP（标准作业程序）。AI Agent 可以通过 tanso skills read 直接读取使用指令，快速掌握如何调用该工具进行特定领域的搜索（如“微信生态”、“瑞幸咖啡门店数据”等），极大降低了 Agent 的学习成本。

4. 隐私安全，无浏览器依赖

Tanso 完全基于 API 交互，无需启动浏览器会话或执行 JavaScript，避免了资源消耗和潜在的隐私泄露风险。所有配置（API Key）均存储在本地配置文件中，支持环境变量优先加载，确保密钥安全。

快速开始

安装

推荐通过 npm 全局安装（会自动下载对应平台的二进制文件并校验 SHA256）：

npm install -g @geekjourneyx/tanso
tanso version

或者使用 Go 安装：

go install github.com/geekjourneyx/tanso/cmd/tanso@v2.0.2

配置

初始化配置文件并填入各平台的 API Key：

tanso config init
# 编辑 ~/.config/tanso/config.yaml 或设置环境变量
# BOCHA_API_KEY, ARK_API_KEY, ZHIHU_ACCESS_SECRET

使用示例

# 搜索 "AI Agent 商业化" 并以 JSON 格式输出
tanso "AI Agent 商业化" --json

# 指定来源：同时从博查和知乎搜索
tanso all "AI Agent 商业化" --source bocha_web --source zhihu_search --json

# 针对特定平台的高级搜索
ZHIHU_ACCESS_SECRET=... tanso zhihu web "ChatGPT 桌面版" --filter 'host=="example.com"' --json

自动化契约与退出码

Tanso 定义了严格的退出码体系，便于上游系统判断执行状态：

• 0: 成功
• 1: 部分成功（部分源失败但仍有结果）
• 4: 凭证缺失
• 5: 源错误
• 7: 无结果

这种明确的契约使得 Tanso 成为构建鲁棒性自动化工作流的理想组件。