BeliefState

BeliefState Agent 集成

将你的 Agent 连接到有引用来源的投资论点、投资风险、催化因素和研究变更。

• Gemini CLI： 使用你的 BeliefState 账户进行远程 MCP 配置。
• 研究技能： 为股票和投资主题问题提供检索指南。
• HTTP 示例： 提供用于免费发现和未签名 x402 报价的 Postman 集合。
• 研究更新工作流： 提供一个无依赖的 Node.js 示例，用于获取最新公司快照和有序的研究变更。

快速开始

安装 Gemini CLI 后：

gemini extensions install https://github.com/Antcolombo/beliefstate-agent-integrations

这会安装一个配置示例。进行身份验证前，请在连接设置中查看客户端当前是否获准接入。 此软件包尚未验证原生 Gemini OAuth 和研究内容交付。 安装扩展或看到授权元数据，并不代表已获得访问权限。如果 Gemini 获准接入，请运行 /mcp auth beliefstate，完成浏览器授权，然后检查免费覆盖范围，再使用你的账户额度或信用额度请求研究内容。 对于受支持的接入方式，请使用已发布的 Claude 连接器；或者使用下方的开发者工作流和你现有的 API 密钥。 请参阅账户设置和定价。

运行公司研究更新

需要 Node.js 22 或更高版本。无需安装依赖项。

获取示例并进入其目录：

git clone https://github.com/Antcolombo/beliefstate-agent-integrations.git
cd beliefstate-agent-integrations

查看带日期的公开研究示例，无需凭据或网络请求：

npm run demo

带日期的样例总结了已验证的 2026 年 10 月 27 日 NBIS 运行：一个带来源链接的当前案例、七条日志事件，以及有意在两次读取上限处停止。待处理的后续内容与已完成的轮询检查点保持分离。覆盖范围、未纳入的案例、未评估的字段和事件领域均明确列出。样例不包含账户身份、凭据和不透明令牌；它是精简的结果摘要，并非完整的 API 响应或当前建议。

不发出任何请求，规划实时工作流：

node examples/research-changes.mjs --ticker NBIS --since 2026-10-20T00:00:00Z

使用研究问题中的公司和截止时间。实时工作流会检查免费发布的覆盖范围，读取包含最多三个案例的精简当前快照，然后请求自该截止时间以来观察到的研究变更的有序日志。输出会保留带归属的证据、来源链接、事件领域、时钟、质量缺口、历史覆盖范围、未纳入项和警告。日志事件可能是引擎评估、分布变更或计算结果；在将其描述为作者修订之前，请先检查其领域。

如需实时账户访问，请从你的密钥存储中加载现有的 BELIEFSTATE_API_KEY。创建密钥或连接 OAuth 不会增加研究额度。执行前，请查看当前账户定价和可用额度：

mkdir -m 700 .private
node examples/research-changes.mjs --ticker NBIS --since 2026-10-20T00:00:00Z \
  --execute --max-reads 2 --state .private/nbis-first.json > .private/nbis-first-output.json

将输出重定向到 .private 之前，先用 mkdir -m 700 .private 创建该目录。如果未重定向输出，脚本也会创建私有状态目录。请妥善保管返回的研究内容、状态和检查点。密钥不会被保存或打印。--test 用于所有者诊断；普通客户使用时应省略此参数。

--max-reads 限制该状态文件中的账户研究调度总次数，包括结果不确定的调度。按 10 月 27 日账户按量付费的费率，两次读取会使用 $0.08 额度；套餐额度和旧版政策可能有所不同。这是读取次数上限，并非货币授权。钱包 x402 数据读取的价格另为 0.02 USDC。此脚本使用账户 REST，不会签署钱包付款；该路径由现有的 x402 快速入门指南负责。

如果日志还有下一页，脚本会保存后续内容，并在读取次数达到上限时停止。使用相同的状态文件和更高的明确上限（最多 20 次）重新运行完全相同的命令即可继续。已完成的结果会在本地复用。范围受限的当前快照不会自动分页；结果中仍会保留其后续内容和未纳入项字段。

日志窗口完成后，使用新的状态文件开始之后的轮询：

node examples/research-changes.mjs --ticker NBIS --previous-state .private/nbis-first.json \
  --execute --max-reads 2 --state .private/nbis-next.json

在新窗口完全读取完毕之前，旧检查点保持不变。resync_required、projection_catching_up 和 history_uninitialized 需要处理；它们不代表“没有变更”。此示例绝不会通过创建新请求来恢复结果不确定的调度：账户请求 ID 可以防止再次扣费，但已完成响应的正文不会被保留以供重放。请保留状态，并在再次尝试前联系支持团队，根据其请求 ID 进行核对。崩溃后留下的 .lock 文件，只有在确认旧进程已停止后才能移除。

使用 npm test 运行离线安全检查。

集成文件

文件	用途
gemini-extension.json	将 Gemini CLI 连接到账号 OAuth MCP 端点。
Research skill	获取并解释带有日期、证据和局限说明的归属明确的投资者观点。
Postman collection	将免费的发现请求和未付费的报价请求导入 Postman。

也可以将此技能复制到兼容客户端的技能目录中。它提供操作说明；托管研究服务的访问权限需另行配置。请遵循客户端自身的安装和身份验证控制措施。

探索 API

以下请求免费且无需账号或钱包：

curl --fail-with-body https://beliefstate.ai/v1/research
curl --fail-with-body 'https://beliefstate.ai/v1/tickers?q=NBIS'
curl --fail-with-body https://beliefstate.ai/v1/research/get_belief

目录列出了全部 16 种付费研究工具及其准确价格：14 种数据工具每次调用收费 0.02 USDC，对比工具收费 0.50 USDC，模型辅助搜索在 Base 上每次调用收费 1.50 USDC。Postman 报价请求会返回付款要求，不会签署或提交付款。

连接选项

访问方式	端点	身份验证
账号 MCP	https://beliefstate.ai/mcp	通过 MCP 客户端使用 OAuth。
钱包 MCP	https://beliefstate.ai/v1/research/mcp	使用兼容的 x402 钱包客户端，并授权支付以读取研究内容。
HTTP API	https://beliefstate.ai	账号 API 访问权限或目录中的 x402 路由。

当前架构请参阅 OpenAPI 合约和 MCP 文档。请将凭据存放在客户端的私密机密存储中。共享集合变量不包含账号凭据或付款授权。

要求与支持

Gemini CLI 需要使用其支持的运行时，并通过本地浏览器访问 OAuth。其他客户端需要支持远程 Streamable HTTP MCP 或 HTTP API。钱包访问需要客户端支持 BeliefState 的 x402 流程；此软件包不会添加付款签名器。客户端特定的登录和生命周期检查与配置验证相互独立。

请在此仓库中报告集成问题。账号或服务问题请联系 [email protected]。安全问题请私下发送至该邮箱。服务信息：beliefstate.ai。

许可证

MIT 适用于 Gemini 配置、上下文和 Postman 集合。MIT 也适用于工作流代码。研究示例仍受服务数据条款约束，并保留其注明的来源和局限性。 研究技能采用 MIT-0 许可证，详见其 frontmatter。托管研究访问权限和数据仍受 BeliefState 服务条款约束。