deepseek-search

DeepSeek 官方 Search / Fetch 接口的零依赖 CLI：一条命令完成联网搜索，或把任意网页抓成 Markdown 正文，结果是带 URL、摘要、发布时间、权威性打分与相关度打分的结构化字段。

运行方式（无需安装依赖）：

node skill.js <command> [args] [options]

快速开始

# 1. 首次使用：直接运行，缺 key 时会主动询问并写入 .env
node skill.js search "DeepSeek 最新更新 lang:zh after:2025"

# 2. 手动写入 key（等价于首次询问）
node skill.js config set-key "<你的 DeepSeek API Key>"

# 3. 抓取单个网页为 Markdown 正文
node skill.js fetch https://api-docs.deepseek.com/zh-cn/guides/search

# 4. 搜索 5 条 + JSON 输出 + 同时返回网页正文
node skill.js search "site:github.com DeepSeek" -n 5 --json --content

# 5. 查看当前配置 / 仅查看 .env 路径
node skill.js config
node skill.js config path

首次使用与 API Key

• 第一次运行任何联网命令时，若 .env 中没有 key，CLI 会主动询问：粘贴 key 后立即写入 .env（默认 deepseek-search/.env，权限 600），之后所有调用自动复用，不需要重复输入。
• 也可以不用询问，手动配置：
  • 直接编辑 .env，写入 DEEPSEEK_API_KEY=...；
  • 或 node skill.js config set-key <key>（同样支持 --key <key> 与 --stdin）；
  • 或临时用环境变量 DEEPSEEK_API_KEY、选项 -k/--api-key <key>（只对本次调用生效，不写盘）。
• key 来源：DeepSeek 开放平台 https://platform.deepseek.com/api_keys ，与 DeepSeek 模型 API 是同一套 key（Bearer 鉴权）。
• 安全约定：.env 已被 .gitignore 忽略，绝不入库；文档、示例、源码中绝不硬编码真实 key；config 输出的 key 一律掩码。
• 脚本 / CI 场景请加 --no-input（或设 DEEPSEEK_NO_PROMPT=1）：它只表示禁止交互询问，不会从 stdin 读取 key。 因此必须已经通过 .env / 环境变量 DEEPSEEK_API_KEY / -k, --api-key 提供 key，否则直接以退出码 3 退出。
• 用 --stdin 把查询词从管道传入时，key 不能在同一个管道里给：缺 key 会直接以退出码 3 退出，请配合 -k / .env / --env-file。

命令总表

config set-key 的专用选项：--key <key>（等价写法 -k <key> / --api-key <key>），或用 --stdin 从管道读取； 配合 --env-file <path> / --dotenv-file <path> 可写入指定的配置文件而不是默认 .env（目标文件还不存在时必须用 --dotenv-file）。

选项表

搜索语法速查

以上语法可以组合使用，例如：

node skill.js search "DeepSeek 模型 site:github.com OR site:huggingface.co lang:zh after:2025"

输出与字段说明

默认输出格式为 table（终端阅读友好）；-f json / --json 适合管道与程序解析，-f markdown 适合直接粘贴进文档。

search 结果字段：

fetch 结果字段： title、content（Markdown 正文）；加 --raw 只输出 content。

HTTP 错误码与处理建议：

408 / 429 / 5xx 可等待重试；402 需充值；其他 4xx 不要重试。错误统一输出为 {"error": "...", "message": "..."} JSON。

退出码：

计费与限速

• 按成功请求次数计费：每 1000 次 5 元。
• 只有 HTTP 200 且产生结果才计费（search 的 results 必须非空）；失败、无结果、超时都不计费。
• count 只影响返回条数，不影响单价。
• Search 与 Fetch 各自 5 QPS，按账号维度计算（与用哪个 key 无关）；Fetch 对目标域名另有 QPS 限制。
• 在 DeepSeek Harness / Claude Code / Codex 中通过服务端工具调用 Search / Fetch，目前未计费；官方文档说明自 2026-11-01 00:00（北京时间） 起按次收费（来源：https://api-docs.deepseek.com/zh-cn/guides/search ）。

常见问题

Q1：key 从哪来？ A：DeepSeek 开放平台 https://platform.deepseek.com/api_keys 创建，与 DeepSeek 模型 API 共用同一套 key，无需另外申请。

Q2：.env 会不会被提交到 git？ A：不会。.env 已被本目录与仓库根两处 .gitignore 忽略，CLI 写入的 key 只落在 .env，不会进入源码、文档或打包产物。

Q3：怎么换 key？ A：三选一：node skill.js config set-key <新key> 覆盖写入；直接编辑 .env 里的 DEEPSEEK_API_KEY；或用 --api-key <新key> / 环境变量临时覆盖本次调用。

Q4：搜索结果为空，为什么没收费？ A：只有 HTTP 200 且 results 非空才算成功请求并计费，空结果、失败、超时都不计费（仍占用 QPS 额度）。结果为空时可放宽条件（去掉 site: 或时间限定）后重试。

Q5：和 DeepSeek Harness / Claude Code 内置搜索是什么关系？ A：内置搜索走服务端工具调用；本 skill 直接调用 DeepSeek 官方 Search / Fetch 接口，字段更全（date、authority、rerank_score），可脚本化、可导出文件。服务端工具调用目前未计费，自 2026-11-01 00:00（北京时间）起按次收费（来源：官方文档）。

详细案例见 examples/（可选）。