Fulcru

fulcru

AI 検索エンジンに名前を挙げてもらいましょう。

誰かが ChatGPT に「小規模チームに最適な CRM は？」と尋ねると、回答には 2、3 個の製品が挙がります。それらが顧客を獲得し、ほかの製品は存在しないも同然です。

fulcru は、AI アシスタントがあなたではなく競合他社の名前を挙げる質問を見つけ、その差を埋めるページを作成し、公開による効果を測定します。CLI、MCP サーバー、エージェントスキルとして動作するため、人間でもエージェントでも一連のプロセスを実行できます。

このリポジトリは、オープンソースでセルフホスト可能なエージェント向けインターフェースです。測定エンジンはホスト型の 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

イメージに秘密情報は含まれていません。トークンは実行時に渡されます。2026-07-27 に node:20-alpine で検証済みです。

一連の流れ

$ 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>	1 つのギャップを埋めるページを作成します。Markdown を標準出力に出力します
fulcru publish <pageId> <url>	ページを公開済みにし、測定の基準となる値を記録します
fulcru delta	公開したページが実際にもたらした効果を表示します
fulcru report [section]	overview、competitors、sources、mentions、prompts

任意のコマンドに --json を追加すると、生のペイロードを取得できます。

エージェント向けに設計

出力は JSON の塊ではなく簡潔な行形式です。呼び出し元は通常 LLM であり、そのコンテキストは限られた貴重なリソースだからです。fulcru gaps の実行に必要なトークンはエージェントあたり約 50 個です。同じデータを API の生の JSON で取得すると約 800 個必要です。fulcru write は Markdown を標準出力に、それ以外のすべてを標準エラー出力に送るため、fulcru write <id> > page.md で余計な情報のないファイルを作成できます。

MCP

Fulcru の 5 つのツールをエージェントに接続する方法は 2 つあります。

リモート（ホスト型）。 トークンを使い、任意の 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 は飾りではありません。このパッケージには 2 つのコマンドが含まれており、これを指定しないと npx はパッケージ名と同じ名前のコマンド、つまり CLI を実行します。その結果、ホストには MCP サーバーではなく使用方法が表示されます。

ツール：fulcru_gaps、fulcru_write_page、fulcru_publish_page、fulcru_delta、 fulcru_visibility。

どちらもプロトコルリビジョン 2026-07-28 と、それ以前のハンドシェイク方式のリビジョンに対応しており、クライアントから送られる情報に応じてリクエストごとに選択します。新しいリビジョンを使うクライアントには server/discover、リクエストごとの _meta、キャッシュ可能なツール一覧を返します。引き続き initialize を送るクライアントには、これまでどおりに応答します。どちらの場合も設定は不要です。

スキル

skills/fulcru スキルは、ウェブアクセスだけで一連の手順を実行します。ドメインを監査し、ギャップを見つけ、ページを作成し、再測定します。アカウントもトークンも必要ありません。スキルに対応したエージェントにインストールしてください。

# 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

コントリビューション

Issue や PR を歓迎します。ツールのロジックはホストされたサービスにあり、このリポジトリには CLI、stdio MCP プロキシ、スキルが含まれています。AI があなたではなく競合他社を挙げた場合は、その質問とともに Issue を作成してください。それこそが、このツールが解決するために作られた課題です。

役に立った場合は、⭐ を付けていただけると本当に励みになります。

ライセンス

AGPL-3.0-or-later。LICENSE を参照してください。