querit-ai/querit-plugins

querit-plugins

面向自动化和 AI 智能体平台的官方 Querit 搜索集成。

Querit 为 LLM 应用提供实时、权威的网页搜索结果和干净的页面内容。本仓库中的每个集成都将一个平台连接到 Querit API（/v1/search + /v1/contents），以实现实时网页搜索和页面抓取——支持引用来源、域名/地区/语言/时间范围过滤，并且输出始终被视为不受信任的网页数据。下面的 Oh My Pi 条目记录的是上游内置提供程序，而非本仓库中的包。

| 平台 | 包 | 安装 |
| --- | --- | --- |
| Pi | pi-querit | pi install npm:pi-querit |
| DeepSeek Harness | dsh-querit | dsh plugin --profile web add dsh-querit |
| OpenCode | opencode-querit | "plugins": ["opencode-querit"] |
| Claude Code | claude-code-querit | /plugin marketplace add querit-ai/querit-plugins |
| n8n | n8n-nodes-querit | 作为 n8n 社区节点安装 |
| Oh My Pi (OMP) | 内置 Querit 提供程序（非插件） | 无需安装；上游 PR 合并后可用 |

本仓库中还有两个集成尚未正式发布：

| 平台 | 目录 | 状态 |
| --- | --- | --- |
| Zapier | zapier-querit/ | 已完成并通过本地验证；等待注册和 Zapier 公开审核 |
| Browserbase | browserbase-querit-demo/ | 参考演示，非已发布的包 |

每个包集成如何读取 API 密钥和搜索默认值，将在下面各自的章节中说明；Oh My Pi 章节记录的是其上游内置提供程序。最近的更新汇总在 CHANGES.md 中。

获取 API 密钥

在 Querit.ai 上注册即可获得 API 密钥，每月 1,000 次免费 API 调用——无需信用卡。同一个密钥适用于所有集成。

pi-querit — Pi

一个 Pi 扩展，将 web_search 和 fetch_content 注册为一等工具。当答案需要实时网页时，你的智能体会自动调用它们。

安装

pi install npm:pi-querit

API 密钥

在 Pi 中运行一次交互式设置向导：

/querit-setup

该向导会验证密钥，然后让你配置持久化的搜索默认值（结果数量、时间范围、国家/地区、语言、域名白名单/黑名单）以及可选的固定模型自动摘要工作流。除 API 密钥外，其他所有内容都可以跳过。

- 密钥所在位置： ~/.pi/agent/querit-search.json（遵循 PI_CODING_AGENT_DIR），在 POSIX 上以 0600 模式写入。
- CI / 临时替代方案： 设置 QUERIT_API_KEY 环境变量。当两者同时存在时，环境变量优先。
- 切勿将密钥放入聊天或日志中： 该扩展会屏蔽密钥输入，并在所有错误界面中对该密钥进行脱敏处理。

完整的工具参考请参阅 pi-querit README。

dsh-querit — DeepSeek Harness

一个用于 DeepSeek Harness ctx.web 能力接缝的提供程序包。它不注册面向模型的 web_search 工具；由 agent 预设来注册。默认情况下，它复用官方的 applyWebFetchTool 辅助函数来注册 web_fetch，并将这两个工具都路由到由 Querit 支持的提供程序。

安装

dsh plugin --profile web add dsh-querit

需要 dsh 0.1.2+ —— v1.1.2 保留了 0.1.2 的主机接缝（ctx.settings 服务、remote.credentials 客户端命名空间），并扩大了 peer 范围，使 0.1.5-rc / 0.1.6-alpha 主机满足 npm。在较旧的 dsh 主机上请固定使用 dsh-querit@1.0.6。

然后在配置文件的 cordis.patch.yml 中接入它：

- insert:
- id: web-search-querit
name: 'dsh-querit'
config:
apiKeyEnv: QUERIT_API_KEY
- id: web
config:
searchProvider: web-search-querit
fetchProvider: web-search-querit

API 密钥 —— 按优先级顺序针对每次操作进行解析：

1. 在启动环境中导出的 QUERIT_API_KEY，或
2. 凭据存储 $DSH_HOME/.credentials.yaml（QUERIT_API_KEY: ，热重载），或
3. web-search-querit 行上的字面量 apiKey（最不推荐 —— 机密不应存放在组合文件中）。

搜索默认值（count、timeRange、countries、languages、includeDomains、excludeDomains、includeContent、chunksPerDoc、抓取格式/超时）在插件行中配置，或在热重载的 $DSH_HOME/settings.yaml 的 web-search-querit: 部分中配置。

完整的配置表请参阅 dsh-querit README。

opencode-querit — OpenCode

一个 OpenCode v2 插件（opencode ≥ 2.0.3），它将 Querit 注册为 websearch 提供程序 —— 为内置的 websearch 工具提供支持，无需 OPENCODE_ENABLE_EXA/OPENCODE_ENABLE_PARALLEL 标志 —— 外加一个由 Querit 爬虫支持的 web_fetch 自定义工具。在 opencode v1 上请固定使用 opencode-querit@1.0.2。

安装

将插件添加到 opencode.json：

{
"$schema": "https://opencode.ai/config.json",
"plugins": ["opencode-querit"]
}

然后重启 OpenCode。在首次调用 websearch 时，在 OpenCode 的提供程序表单中选择 Querit，或使用 "websearch": { "provider": "querit" } 一次性固定它。

API 密钥 —— 按优先级顺序针对每次调用进行解析：

1. QUERIT_API_KEY 环境变量（默认；可通过 apiKeyEnv 重命名），或
2. 插件选项中的 apiKey（最不推荐 —— 机密不应存放在配置文件中）：

{
"$schema": "https://opencode.ai/config.json",
"plugins": [
{ "package": "opencode-querit", "options": { "count": 8, "timeRange": "m3", "languages": ["english"] } }
]
}
搜索默认值和抓取行为的配置方式相同（count、timeRange、countries、languages、includeDomains、excludeDomains、includeContent、chunksPerDoc、fetchFormat、fetchCrawlTimeout、fetchMaxChars、maxOutputChars）。

完整的配置表和本地测试说明请参见 opencode-querit README。

claude-code-querit — Claude Code

一个 Claude Code 插件，捆绑了一个 stdio MCP 服务器，暴露 web_search 和 fetch_content，外加一个 /querit-ai:research 技能，用于生成有来源依据并带引用的答案。

安装

/plugin marketplace add querit-ai/querit-plugins
/plugin install querit-ai@querit

API 密钥 — 该插件只读取 QUERIT_API_KEY 环境变量，MCP 服务器进程从启动 Claude Code 的环境中继承该变量。产品内刻意不提供密钥选项：一个变量即可覆盖本地开发、CI 和 UI 安装。

- 切勿将密钥放入 .mcp.json、源文件、shell 历史记录、聊天或日志中。工具错误会在 Claude 看到之前对当前生效的密钥进行脱敏处理。

当必需选项未设置时，Claude Code 不会启动插件的 MCP 服务器，因此在期望 Querit 工具出现在 /mcp 中之前，请先配置 api_key。

完整的工具参考和安全限制请参见 claude-code-querit README。

n8n-nodes-querit — n8n

一个 n8n 社区节点，提供 Search Web 和 Fetch Content 操作，原生支持配对项和 Continue On Fail 处理，并支持 AI 工具。

通过 n8n 的社区节点界面安装 n8n-nodes-querit，然后创建一个 Querit API 凭据并粘贴 API 密钥。n8n 会将其存储为加密凭据；该节点绝不会将其写入工作流 JSON 或执行数据。操作详情和开发说明请参见 n8n-nodes-querit README。

querit — Oh My Pi (OMP)

待合并的上游 OMP 变更为其 web_search 提供商链以及内置 read 工具所使用的 URL 抓取/读取路径添加了内置的 Querit 提供商。这不是本仓库中的 npm 插件，因此这里无需安装任何内容。在上游 PR 合并后可用。

凭据

- 在启动 OMP 的环境中设置 QUERIT_API_KEY，或
- 在 OMP 中运行 /login querit，并在提示时粘贴/保存密钥。

选择 Querit

在上游 PR 合并后，将 Querit 设为第一个 web_search 提供商，并选择它用于 URL 抓取：

omp config set providers.webSearchOrder '["querit"]'
omp config set providers.fetch querit
providers.webSearchOrder 控制 web_search 提供程序的优先级，而 providers.fetch 控制当 OMP 的 read 工具获取 HTTP(S) URL 时使用的读取器后端。上游变更落地后，其搜索提供程序将向 POST https://api.querit.ai/v1/search 发送请求，仅携带 { query, count }（count 默认为 10，并被限制在 1..20 范围内），而其 URL 内容读取器将向 POST https://api.querit.ai/v1/contents 发送请求；两者均使用 Bearer 认证。Querit 特定的语言、站点/域名和日期选项保持未设置，因此服务将使用其默认值。

zapier-querit — Zapier

一个 Zapier Platform CLI 集成，包含一个搜索操作，Find Web Search Results。认证方式为掩码的自定义 API 密钥字段，通过固定的单结果 POST /v1/search 进行测试。

该集成尚未发布到 Zapier 的应用目录。注册、私有测试推送和公开审核都需要公司拥有的 Zapier 开发者账户；zapier-querit README 包含完整的交接清单。

browserbase-querit-demo — Browserbase

一个参考演示，而非可安装的包：它使用 Querit 进行搜索，然后通过 Playwright connectOverCDP 在 Browserbase 云浏览器中打开顶部结果，并保存截图作为证据。它需要在环境中同时提供 QUERIT_API_KEY 和 BROWSERBASE_API_KEY，并且刻意不读取 .env 文件。参见 browserbase-querit-demo README。

仓库布局

每个目录都是一个独立的 npm 包，拥有自己的版本、CI 和发布周期。没有根工作区：各集成拥有独立的依赖树，因此每个包保留自己的 package.json、锁文件和 node_modules。

querit-plugins/
├── .claude-plugin/            # Claude Code 市场目录
├── pi-querit/                 # Pi 扩展（TypeScript，无构建步骤）
├── dsh-querit/                # DeepSeek Harness 提供程序包（已提交编译后的 lib/）
├── opencode-querit/           # OpenCode 插件（已提交编译后的 lib/）
├── claude-code-querit/        # Claude Code 插件（可安装载荷位于 plugin/）
├── n8n-nodes-querit/          # n8n 社区节点（为发布而编译）
├── zapier-querit/             # Zapier CLI 集成（未发布）
└── browserbase-querit-demo/   # Browserbase 参考演示（未发布）

开发

在包目录内工作；根目录没有脚本。执行 npm ci 后，运行该包的检查门：

| 包 | 检查门 |
| --- | --- |
| pi-querit/ | npm run check && npm test |
| dsh-querit/ | npm run check && npm run build && npm test |
| opencode-querit/ | npm run check && npm run build && npm test |
| claude-code-querit/ | npm run verify |
| n8n-nodes-querit/ | 使用 npm ci --ignore-scripts 安装，然后 npm run check && npm run lint && npm test && npm run build |
| zapier-querit/ | npm run check && npm run build |
| browserbase-querit-demo/ | npm run check && npm test && npm run build |

每个 npm 包在发布时（prepack）都会自动运行其门禁，因此手动运行仅在开发期间才有意义。Claude Code 市场目录从仓库根目录单独验证：

claude plugin validate . --strict
claude plugin validate ./claude-code-querit/plugin --strict

发布是按包进行的。dsh-querit、opencode-querit 和 pi-querit
会自动发布：在包目录中运行 npm version  --no-git-tag-version（以便 package.json 和 package-lock.json 保持同步），
提交并推送到 main。每个包的发布工作流会跳过版本已在 npm 上的推送，
否则会运行包门禁并以 npm provenance 发布。n8n-nodes-querit 保留其标签触发
流程：推送一个 n8n-nodes-querit@ 标签。所有这些工作流都通过
npm 可信发布（OIDC，无 NPM_TOKEN）进行发布；每个包都需要在其 npm 设置中
一次性添加一个 GitHub Actions 可信发布者条目，指向其工作流文件。

许可证

MIT — 请参阅每个包的 LICENSE 文件。