driftwatch

driftwatch

AI コーディングエージェント向けの依存関係移行インテリジェンス。

次の質問に、正確に、出典を引用して回答します。

このライブラリはバージョン A からバージョン B に移行しました。何が壊れ、コードをどう修正すればよいですか？

初めての方は、初心者向けガイドから始めてください。

このリポジトリには、CMM Research が Apify 上で公開しているdata Actorsのソースコードも含まれています。求人、病院、資金調達、Shopify のデータ API を提供します。

---

インストール（30 秒）

Claude Desktop、Claude Code、Cursor、その他の MCP クライアントに追加してください。

{
  "mcpServers": {
    "driftwatch": {
      "command": "npx",
      "args": ["-y", "driftwatch-mcp"]
    }
  }
}

設定はこれだけです。**API キーも、アカウントも、支払いも、設定も不要です。**エンジンはお使いのマシン上でローカルに動作し、npm、PyPI、GitHub Releases、OSV.dev の公開データのみを読み取ります。

エージェントに次の 2 つのツールが追加されます。

ツール	機能
get_migration_delta	バージョン A と B の間で何が壊れたのかを、すべての主張に出典を添えて回答します
check_package	このパッケージは実在するかを確認します。インストール前に、幻覚による名前やタイポスクワッティングされた名前を検出します

必要に応じて ANTHROPIC_API_KEY を設定すると、決定論的な結果に加え、LLM が生成した移行手順も利用できます。キーを設定しなくても、すべての機能が動作します。

---

なぜこれが必要なのか

すべての LLM は、トレーニングの対象期間が終了した時点の状態に固定されています。一方、ライブラリは変化し続けます。エージェントが対象期間より後のバージョンに対してコードを書くと、すでに存在しない API を自信満々に出力し、真実にたどり着くまでビルドと修正をおよそ 6 回繰り返すことになります。

**SDKProof ベンチマーク（2026 年 7 月）**では、この点が測定されました。Prisma v7 では 80/100（v6 の PrismaClient パターンは削除済み）、Vercel AI SDK v5+ では 90/100（パラメーター名が変更され、maxSteps が削除済み）というスコアでした。

Without driftwatch:  ~6 failed iterations x ~15k tokens  ->  $0.30-$1.50 + 10-20 min
With driftwatch:     1 call                              ->  $0.05

購入者自身が算出できる、6～30 倍のリターンです。信頼は必要ありません。

---

クイックスタート

npm install
cp .env.example .env
npm start

# The product
curl "localhost:4021/v1/delta?ecosystem=npm&name=react&from=18.2.0&to=19.0.0"

# Free safety check -- catches hallucinated and typosquatted packages
curl "localhost:4021/v1/check?ecosystem=npm&name=recat"

支払い機能と有料 AI 機能を無効にして動作します。費用はかかりません。

---

利用できる機能

{
  "package": "react",
  "from": "18.2.0", "to": "19.0.0",
  "jump": { "kind": "major", "majorsCrossed": 1, "releasesInRange": 583 },
  "tier": "evidence",
  "breakingChanges": [
    {
      "summary": "Removed: `ReactDOM.render`, `ReactDOM.hydrate` ...",
      "version": "19.0.0",
      "confidence": "medium",
      "symbols": ["ReactDOM", "render", "hydrate"],
      "citations": [{ "kind": "release-note", "url": "https://github.com/..." }]
    }
  ],
  "advisories": [],
  "citations": [ /* every source we relied on */ ]
}

すべての主張には、一次情報へのリンクが付いています。公開するのは事実と短い引用であり、ドキュメントを丸ごと掲載することはありません。

---

アーキテクチャ

                 ┌──────────────────────────────────────────┐
                 │   FREE PUBLIC SOURCES  (no licensed data) │
                 │   npm · PyPI · GitHub Releases · OSV.dev  │
                 └────────────────────┬─────────────────────┘
                                      │
                          ┌───────────▼───────────┐
                          │   ENGINE               │
                          │  ┌──────────────────┐  │
                          │  │ deterministic    │  │  always on, $0
                          │  │ extraction       │  │
                          │  └────────┬─────────┘  │
                          │  ┌────────▼─────────┐  │
                          │  │ LLM synthesis    │  │  OPTIONAL, capped
                          │  │ (off by default) │  │
                          │  └────────┬─────────┘  │
                          └───────────┼────────────┘
                                      │
                          ┌───────────▼───────────┐
                          │  SQLite PERMANENT CACHE│  ← the margin
                          │  + revenue ledger      │
                          └───────────┬───────────┘
                                      │
              ┌───────────────────────┼───────────────────────┐
              │                       │                       │
      ┌───────▼───────┐      ┌────────▼────────┐    ┌────────▼────────┐
      │  MCP server   │      │   HTTP API      │    │  x402 layer     │
      │  (stdio)      │      │   + OpenAPI     │    │  (Base, USDC)   │
      │               │      │                 │    │                 │
      │ DISTRIBUTION  │      │    REVENUE      │    │   OPTIONALITY   │
      └───────────────┘      └─────────────────┘    └─────────────────┘

**戦略を一言で言うと：**MCP にはユーザーが集まり、API は収益を生み、x402 は低コストでのポジショニングに使えます。その理由についてはDECISION.mdを、測定結果についてはMARKET_RESEARCH.mdをご覧ください。

---

エンドポイント

エンドポイント	価格	用途
GET /v1/delta	$0.05	製品機能 — 2 つのバージョン間の破壊的変更
POST /v1/manifest	$0.15	バッチ分析。最大 50 パッケージに対応
GET /v1/check	無料	このパッケージは実在するか、タイポスクワッティングかを確認
GET /health	無料	稼働状態
GET /openapi.json	無料	機械可読な仕様
GET /llms.txt	無料	エージェント向けの要約
GET /.well-known/x402	無料	支払い情報の検出
GET /admin/stats	localhost	収益とコストの台帳

対応エコシステム：npm、PyPI。

---

MCP サーバー

配布チャネルです。get_migration_delta と check_package の 2 つのツールを提供します。

driftwatch-mcpとして公開されています。1 ブロックで設定する方法については、上記のインストールをご覧ください。

npm を使わず、クローンから実行するには：

{
  "mcpServers": {
    "driftwatch": {
      "command": "node",
      "args": ["--experimental-strip-types", "/path/to/driftwatch/src/mcp/server.ts"]
    }
  }
}

デフォルトではエンジンをローカルで実行するため、こちらへのネットワーク通信も支払いもありません。ホストされたインスタンスを使う場合は、DRIFTWATCH_REMOTE_URL を設定してください。

ネイティブ依存関係は不要です。better-sqlite3 は任意です。お使いのマシンでビルドできない場合、サーバーはプレーンな JSON キャッシュに切り替わり、同じように動作します。ネイティブビルドの失敗は、MCP サーバーがインストール時に動かなくなる最も一般的な原因ですが、このサーバーはその場合でも問題なく動作します。

---

コマンド

npm start           # run the API server
npm run dev         # run with auto-reload
npm run mcp         # run the MCP server (stdio)
npm test            # unit tests -- no network, no cost
npm run testclient  # simulate a customer end to end
npm run wallet:new  # generate a TESTNET wallet

---

セキュリティについて一言で

このサーバーが秘密鍵を保持することはありません。 暗号資産を受け取るのに必要なのは公開アドレスだけです。鍵が必要なのは支出するときだけで、当サーバーが受け取るのは常に入金のみです。サーバーが侵害されても、キャッシュと台帳が手に入るだけです。盗める資金はありません。LLM の利用額には日次上限があり、呼び出しのたびに事前確認されます。詳細はdocs/SECURITY.mdをご覧ください。

---

誠実な現状報告

リリース済みですが、まだ誰にも使われていません。 2026年8月23日時点で、npm パッケージは公開されており、クリーンインストールで正常に動作することを確認済みです。また、オーガニックユーザーはゼロです。これが偽りのない現状です。コードは動きますが、配布はまだ始まっていません。

これはまだ検証されていないビジネスです。 実測された事実は次のとおりです。

• 独立系 x402 販売者のエコシステム全体の規模は、登録済みサービス14,128件で月約11,700ドルです（2026-08-07測定。MARKET_RESEARCH.mdを参照）。
• 最も成功している独立系運営者の収益は月約872ドルです。
• ほとんどのコーディングエージェントは、人間のサブスクリプション内で動作しており、ウォレットを持っていません。

つまり、無料の MCP 利用が有料呼び出しを大幅に上回り、初年度の x402 収益はほぼゼロになると見込んでください。このサービスは、そのような結果でも月約1ドルのコストで運用でき、実際に役立つものを提供できるように構築されています。

重要な指標は収益ではなく、支払者1人あたりの呼び出し回数です。5回未満なら物見遊山です。収益がごくわずかでも、20回を超えれば本格的なビジネスです。

---

Apify のデータ Actor

actors/ フォルダーと src/jobs/ には、CMM Research が提供する有料データ Actor のソースコードがあります。それぞれApify上で動作し、結果ごとの従量課金と AI エージェント向けの MCP エンドポイントを備えています。

Actor	内容
キャリアサイト求人 API	19,000社以上の企業が運営するキャリアサイト（Workday、Oracle、Greenhouse など14サイト以上）から、募集が継続中の求人180万件以上を検索します。給与情報付きで、毎晩更新されます
米国の病院・看護師・医療関連の求人	米国の大規模医療システム68社で募集中の求人113,000件以上を掲載。職種、部門、シフト、日雇い／出張勤務、入社ボーナスで分類されています
Greenhouse、Lever、Ashby の求人	3,500社以上のスタートアップの求人ボードから、給与情報付きの求人をリアルタイムで取得します
Workday 求人スクレイパー	あらゆる myworkdayjobs.com サイトの全求人を取得します。Workday の検索結果上限2,000件を超えて取得できます
あらゆる職種で採用中の企業	特定の職種で採用中の企業を1社1行で掲載します。募集中の求人、新規職種、採用の伸びを確認できます
最近資金調達した企業（SEC Form D）	SEC の提出書類から、最近プライベート資金を調達した米国企業を確認できます
Shopify ストアの見込み顧客	ニッチ分野、国、アプリ、テーマで分類された、稼働中の Shopify ストア188,000件以上を掲載。公開されている連絡先情報付きです

Kaggle で無料サンプルを公開しています：求人、病院の求人、資金調達ラウンド、Shopify ストア。

ドキュメント

ファイル	内容
BEGINNER_GUIDE.md	平易な英語で書かれたすべての情報
MARKET_RESEARCH.md	x402、MCP、エージェント決済の実測状況
OPPORTUNITIES.md	検討した20のビジネスとその順位
DECISION.md	この案を選んだ理由と、率直な注意点
PROJECT_STATUS.md	完了／進行中／次の予定
docs/SECURITY.md	鍵の管理、支出制御、脅威モデル
docs/ECONOMICS.md	ユニットエコノミクスと3つのシナリオ
docs/COSTS.md	導入を決める前に確認できる、継続的に発生するすべてのコスト
docs/DEPLOYMENT.md	Mac Mini → インターネット → メインネット → VPS
DAY_1.md … MONTH_1.md	具体的なローンチ計画

---

データソースと倫理

すべての入力データは無料で公開されており、ライセンスの制約もありません。npm registry、PyPI、GitHub Releases、OSV.devが該当します。

ライセンス付きデータの再販は意図的に行っていません。現在、x402で最も収益を上げている独立系事業者は、有料API（People Data Labs、Exa、Firecrawl）をプロキシしており、おそらく利用規約に違反しています。これはx402で実証されている唯一のビジネスモデルですが、採用しないことにしました。

事実は簡潔な引用とリンクを添えて公開します。ドキュメントをそのまま複製することはありません。