ResultGate

ResultGate

面向 BrowserAct、SearchApi、PDF.co、Make、Apify 和 Firecrawl 的本地 MCP 服务推荐，提供明确披露的推荐链接和证据检查。0.3.1 版：PyPI。

正在寻找服务推荐？

通过 uv 安装指定版本的软件包（Python 3.11+；无需 Git）：

{"mcpServers":{"resultgate-referrals":{"command":"uvx","args":["resultgate-pilot==0.3.1","--referrals"]}}}

此本地 stdio 入口恰好提供六个工具： list_referral_providers、recommend_referral_service、prepare_referral_task、 assess_browseract_fit、validate_browseract_report、validate_browseract_csv。 前三个工具涵盖全部六家服务商。无需密钥、注册或购买；安装依赖需要网络连接，但工具调用不会执行服务商功能，也不会上传遥测数据。优先考虑现有、本地或免费解决方案；佣金不会影响能力匹配。

示例流程：调用 list_referral_providers，然后使用 request={"need":"browser_interaction","sources_permitted":true, "local_solution_sufficient":false} 调用 recommend_referral_service，再使用 request={"provider_id":"browseract","sources_permitted":true} 调用 prepare_referral_task。 响应包含官方联盟链接 https://browseract.com?fpr=ahed-ddc97e、经过测量的 /go/browseract 替代链接以及佣金披露。引导操作不代表注册、销售或佣金。

运行 pip install resultgate-pilot==0.3.1 后，resultgate-referrals 是等效的独立入口；resultgate-pilot --referrals 是 Registry 入口。 原有的 resultgate / resultgate-pilot 默认行为和经纪标记仍可供现有客户端使用。旧版 0.2.0 不包含推荐工具。

公开目录 无需账户即可查看。托管的 /mcp 是单独的认证网关，并非此本地配套工具。在该网关上未经认证而收到 401，并不表示本地服务已停止。切勿为了通过目录健康检查而禁用网关认证。 Glama 架构刷新和 MCP Registry 发布与软件包发布彼此独立。

示例和权限标记 · 隐私和计数器 · 0.3.1 版发布/迁移说明。

通过检查不代表保证真实。 原有检查工具会评估你提供的证据；它们不会获取来源、检测所有缺失事实、验证来源真实性，也不会判断语义支持情况。完成证据不完整时，结果为 unknown。

旧版检查模式：从 PyPI 安装（Python 3.11+）

python3 -m venv .venv
.venv/bin/python -m pip install resultgate-pilot==0.3.1
.venv/bin/resultgate-pilot --help

对于已安装 uv 的 MCP 客户端：uvx resultgate-pilot==0.3.1。

从 GitHub 安装（Python 3.11+ 和 Git）

python3 -m venv .venv
.venv/bin/python -m pip install git+https://github.com/AHEDMUNI/resultgate.git
.venv/bin/resultgate --help

如需可复现的部署，请在 Git URL 后附加 @<reviewed-commit-sha>。

从本地构建的 wheel 安装

在 Linux/macOS 上，检查构件及其 SHA-256 后：

python3 -m venv .venv
.venv/bin/python -m pip install ./resultgate_pilot-0.3.1-py3-none-any.whl
.venv/bin/resultgate --help

在 Windows 上，使用 py -m venv .venv 和 .venv\Scripts\python.exe -m pip install <wheel>；可执行文件为 .venv\Scripts\resultgate.exe。在本次发布审查中，尚未测试 Windows/macOS 上的执行情况。

公开软件包同时提供 resultgate 和 resultgate-pilot 可执行文件。

旧版检查模式：连接 MCP 客户端

配置已安装可执行文件的绝对路径；它会在本地通过 stdio 运行，无需 API 凭据：

{"mcpServers":{"resultgate":{"command":"/ABSOLUTE/PATH/.venv/bin/resultgate"}}}

可发现的工具：check_extraction 和 check_citations。每个工具都接受 payload 和可选的 usage 对象。工具输入/输出架构由官方 Python MCP SDK 提供。默认情况下不会发起网络请求，也不会记录使用情况。此本地服务信任调用它的操作系统用户；它并非用于运行不可信进程的沙箱。

启用经纪与委派

{"mcpServers":{"resultgate":{"command":"/ABSOLUTE/PATH/.venv/bin/resultgate","args":["--brokerage","--delegation"]}}}

这会开放 12 个工具，同时保持外部执行处于禁用状态。0.3.1 Registry 配置会改为启动独立的 --referrals 模式。本地提供方入驻会通过显式指定的私有 Registry 目录新增 5 个工具。请参阅已安装客户端教程和提供方申请流程。不提供共享托管网络、符合规范的 A2A 传输、提供方自动执行或支付功能。GROBID 是可选的 ML 演示，并非自主 Agent。

提取示例

{"payload":{"records":[{"id":"a","name":"Example"}],"required_fields":["/name"],"unique_fields":["/id"],"expected_count":1,"job_status":"completed","next_cursor":null,"truncated":false}}

预期状态：pass，适用范围仅限 caller_supplied_contract_only。

字段使用 RFC6901 JSON 指针；unique_fields 会构成复合键。必需字段缺失、为 null 或空白时会失败；零和 false 均为有效值。计数针对提供的整个数据集，而非页面或提供方任务。预期总数必须来自适当的外部契约，不能简单使用 len(records)。已知失败、抓取进行中、待处理游标、重复游标、明确截断、计数不匹配和重复键都会导致失败。若没有确定的失败，但缺少预期计数、完成状态、下一个游标的证据或截断证据，则结果为未知。只有 next_cursor 可以为 null；对于未知的 expected_count/truncated，应直接省略。

限制：序列化输入为 1 MiB、JSON 节点数为 100,000、深度为 32、记录数为 5,000，每个字段列表最多包含 64 个指针。最多返回 100 条发现，同时提供总数。

引用示例

{"payload":{"sources":[{"id":"s1","text":"The launch was postponed."}],"citations":[{"source_id":"s1","quote":"The launch was postponed.","start":0,"end":25}]}}

仅进行精确的 Unicode 字面匹配。可选偏移量必须成对提供，且以代码点计数，而非字节或 UTF-16 单元。匹配的引文仍可能具有误导性，或被用于支持错误主张。空引文会产生未知结果。重复的来源 ID 会被拒绝。不提供偏移量时，所有搜索的总搜索量上限为 2,000 万个来源字符；较大的请求请拆分处理，或提供精确偏移量。不会获取任何 URL，也不会执行来源文本中的指令。

可选的本地认证 HTTP API

export RESULTGATE_API_TOKEN="$(python3 -c 'import secrets; print(secrets.token_urlsafe(32))')"
.venv/bin/resultgate --http
curl -H "Authorization: Bearer $RESULTGATE_API_TOKEN" -H 'Content-Type: application/json' --data-binary @examples/extraction.json http://127.0.0.1:8765/v1/extraction

POST /v1/extraction 和 /v1/citations 接受载荷本身，无需 MCP 的 payload 包装。GET /health 仅提供信息。HTTP 模式绑定到回环地址；审计需要配置密钥；会拒绝浏览器 Origin 和无法识别的 Host；限制请求正文大小和读取时间，并禁用访问日志。这不是公开托管 API，也不是远程 MCP 端点。请勿通过隧道或反向代理公开此服务。尚未实现 HTTP 用量统计。

保护隐私的可选本地用量统计

默认不进行分析。若要自愿参与试点，请在 MCP 命令中添加 --usage-dir /YOUR/PRIVATE/DIRECTORY，然后在真实任务使用检查工具时传入 usage:{"task_id":"opaque-task-identifier","purpose":"real_task"}。重试时请重复使用任务 ID。测试/演示/重试用途以及未提供用量上下文的调用均不计入统计。请参阅 PRIVACY.md。

使用 .venv/bin/python -m resultgate.local_usage /YOUR/PRIVATE/DIRECTORY --export 导出数据，供自行审阅。不会自动上传任何内容。共享摘要为自我报告；不会自动计作独立采用情况或收入。

开发与限制

python3 -m venv .venv
.venv/bin/python -m pip install -e '.[test]'
.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python benchmark.py

单元测试和全新安装测试仅供内部使用。合成基准测试夹具用于衡量规则覆盖率，而非生产环境中的准确性，也不用于证明其优于完整的竞品。测试不使用付费模型、浏览器或 API。Python 3.12/Linux 是经过测试的全新安装环境。推荐入口不会启动托管端点或支付功能；这些测试不能证明存在外部客户。

许可证：MIT，已包含在 LICENSE 中。有关安全范围，请参阅 SECURITY.md；有关依赖项，请参阅 THIRD_PARTY.md。

可选的本地试点：提供方入驻、发现与佣金收款试点。可选的 17 工具配置；没有托管网络、A2A 端点或支付功能。合作伙伴尽职调查。

本地试点：启动／安装／MCP 示例 · 提供方申请 · 仅供审核的佣金工作表。没有公共共享运行时，也不会自动批准提供方。

可选的市场模拟

ResultGate 旨在为请求方 Agent 与专业 Agent 之间经授权的工作提供撮合服务。已发布的本地试点并非共享市场。当前源码包含只读佣金报告；新开发必须区分模拟、运营方证明、已验证的付费事件和实际收取的收入。不计划收取订阅费或上架费；佣金必须以双方明确约定并达成符合条件的结果为前提。

请参阅 Agent 集成与能力发现、共享市场原型的边界以及首笔商业交易的关卡。0.3.1 软件包包含这些模块，但推荐入口不会启用它们。

此开发分支提供了一个仅限环回的共享存储 HTTP 测试工具，用于隔离的客户端测试。它会记录模拟，不会执行提供方任务或支付，且不得公开访问。外部专业服务试用与成本控制说明了一个无需银行卡的首次实验，以及一个需单独批准的付费备选方案。