Fulcru

fulcru

让 AI 搜索引擎提及你的名字。

当有人问 ChatGPT“哪款 CRM 最适合小团队”时，答案会提到两三个产品。它们能获得客户，其他产品则无人问津。

fulcru 会找出 AI 助手提到竞争对手而非你的问题，撰写填补差距的页面，并衡量发布页面带来的效果。它以 CLI、MCP 服务和 Agent 技能的形式运行，因此人类或 Agent 都能完成整个流程。

此仓库提供开放、可自托管的 Agent 接入层。测量引擎由托管的 Fulcru 服务提供；这里的一切都是轻量客户端，使用你的令牌与其通信。

我们用它来测量自己，并公开结果，无论结果如何。目前我们的得分是 34 个提示词中 0 个：我们销售 AI 可见度服务，自己的产品得分却是零，其中包含完整运行记录和源数据。

npm install -g fulcru
export FULCRU_TOKEN=pk_...        # Settings -> Integrations at fulcru.app

或者使用 Docker 运行，无需在主机上安装任何东西：

docker build -t fulcru .
docker run --rm -e FULCRU_TOKEN=pk_... fulcru gaps

镜像中没有打包任何密钥；令牌会在运行时传入。已在 node:20-alpine 上验证，日期为 2026-07-27。

工作流程

$ fulcru gaps
  0%  k57jc...  best AI visibility tracker for a SaaS startup -> AI names Profound, Peec AI
  0%  k57bw...  how do I know if ChatGPT recommends my brand -> AI names Otterly AI
 33%  k57xz...  tools to track brand mentions in Perplexity -> AI names Semrush

Write the top one:  fulcru write k57jc...

$ fulcru write k57jc... > page.md     # the drafted article, grounded in what AI cites
$ fulcru publish k57jc... https://mysite.com/blog/ai-visibility-trackers
Published. Baseline: AI names you in 0% of 9 measured answers.

$ fulcru delta
    0% ->  44%  +44pts  Best AI Visibility Trackers, Compared

最后这一行就是全部意义所在。

命令

命令	功能
fulcru gaps [n]	AI 提到竞争对手而非你的问题，按最差情况排序
fulcru write <promptId>	撰写填补某个差距的页面；将 Markdown 输出到 stdout
fulcru publish <pageId> <url>	标记页面已上线，并记录基准快照以便后续测量
fulcru delta	查看已发布页面的实际效果
fulcru report [section]	overview、competitors、sources、mentions、prompts

为任何命令添加 --json，即可获取原始负载。

专为 Agent 打造

输出采用简洁的行格式，而非 JSON 块，因为调用方通常是大模型，而它的上下文资源有限。fulcru gaps 约消耗 Agent 50 个令牌；同样的数据若以原始 API JSON 形式输出，则约消耗 800 个令牌。fulcru write 会将 Markdown 输出到 stdout，其他所有内容输出到 stderr，因此 fulcru write <id> > page.md 可以生成干净的文件。

MCP

有两种方式可将五个 Fulcru 工具接入 Agent。

远程（托管）。 使用你的令牌，将任意 MCP 客户端指向托管端点：

{
  "mcpServers": {
    "fulcru": {
      "url": "https://little-orca-977.convex.site/mcp",
      "headers": { "Authorization": "Bearer pk_..." }
    }
  }
}

本地（stdio）。 对于偏好使用子进程的宿主，此软件包提供一个 stdio MCP 服务，用于代理请求到托管端点：

{
  "mcpServers": {
    "fulcru": {
      "command": "npx",
      "args": ["-y", "-p", "fulcru", "fulcru-mcp"],
      "env": { "FULCRU_TOKEN": "pk_..." }
    }
  }
}

-p 不是装饰选项。此软件包提供两个命令，不加 -p 时，npx 会运行以软件包命名的命令，也就是 CLI：宿主看到的会是用法说明，而不是 MCP 服务。

工具：fulcru_gaps、fulcru_write_page、fulcru_publish_page、fulcru_delta、fulcru_visibility。

两者都支持协议修订版 2026-07-28 和更早的基于握手的修订版，并会根据客户端发送的内容逐个请求选择修订版。使用新版修订版的客户端会获得 server/discover、逐请求的 _meta，以及可缓存的工具列表；仍发送 initialize 的客户端则会像以前一样得到服务。无论哪种方式，都无需进行任何配置。

技能

skills/fulcru 技能仅通过 Web 访问即可运行完整流程——审计域名、发现差距、撰写页面、重新测量——无需账户和令牌。将它安装到支持技能的 Agent 中：

# Claude / OpenClaw
npx skills add gsmmediaro/fulcru

# Hermes
hermes skills install gsmmediaro/fulcru

Hermes 会在安装前扫描第三方技能并打印判定结果，让你知道自己即将运行什么。如果你更想将此仓库作为源跟踪并获取更新，也可以直接添加它：

hermes skills tap add gsmmediaro/fulcru
hermes skills install fulcru

当你希望它持续测量所有引擎，并为你跟踪前后差异时，请使用上面的 CLI 和 MCP。

配置

环境变量	必填	默认值	用途
FULCRU_TOKEN	CLI + 本地 MCP 必填	—	你的账户令牌（Settings -> Integrations）
FULCRU_ENDPOINT	否	https://little-orca-977.convex.site/mcp	指向可自托管或使用自定义域名的端点

此仓库中不包含任何密钥。令牌仅读取自环境变量。

自托管

技能无需任何配置。CLI 和 MCP 需要 Fulcru 账户才能运行持续、可衡量的循环；如果你运行自己的实例，可将 FULCRU_ENDPOINT 指向该实例。

提供了 Docker 镜像：

docker build -t fulcru .
docker run --rm -e FULCRU_TOKEN=pk_... fulcru gaps

贡献

欢迎提交问题和 PR。工具逻辑位于托管服务中；此仓库包含 CLI、stdio MCP 代理和技能。如果 AI 提到了竞争对手而不是你，请针对该问题提交 issue——这正是此项目旨在弥补的不足。

如果这对你有帮助，点一个 ⭐ 就真的很有帮助。

许可证

AGPL-3.0-or-later。请参阅 LICENSE。