画像比較API：画像の類似性スコアリングと重複画像の検出

視覚的な類似性で画像を比較し、完全一致および近似重複をプレーンなHTTP APIでキャッチします。1つのソース画像とターゲットのリストを渡すと、各比較ごとに類似性スコア、重複判定、および知覚ハッシュ距離を含む1行が返されます。

Apify 上の Image Similarity API Actor で動作します。このリポジトリでは、Pythonクイックスタートと5つのクライアント向けMCPインストール手順の2つの方法を示しています。

テキストによるウォークスルー

この画像比較APIは、「この2つの画像はどれくらい似ているか？」という1つの質問に答えます。sourceImage URLとtargetImagesリストを渡すと、各ターゲットに対して0から1の間のsimilarityScore、thresholdに対して測定されたisSimilarフラグ、そして平易な言葉によるverdictが返されます。内部では2つの独立した手法を実行します。CLIPビジョン埋め込みはコンテンツを理解し、トリミング、色変更、再エンコードされた写真でもマッチングします。そして知覚ハッシュ（pHashおよびdHash）は低コストでバイトレベルの近似重複をキャッチします。comparisonModeをembedding、phash、またはbothに設定して、課金対象のシグナルを選択します。ほとんどの人が求めるのは重複検出パスです。自分でダウンロードすることなく、URLのリストを指定してオンライン上の重複画像を見つけます。また、2つの画像を目視ではなく数値で比較する必要がある場合（例えば、スクリーンショットをベースラインと比較してレイアウト変更をフラグするなど）にも最速の方法です。

Related MCP server: Vision MCP Server

クイックスタート

uv sync
cp .env.example .env      # paste your Apify token into .env
uv run image-similarity-api-example.py

無料のApify APIトークンをhttps://apify.com?fpr=9n7kx3で取得します（コンソール → 設定 → API & Integrations）。

この例では、各実行を1つのソースに対して2～3つのターゲットと小さく保つため、最初の実行はほとんどコストがかかりません。Actorは実行あたり最大500ターゲットまで受け入れます。

レシピ

それぞれApify Storeで公開されている、すぐに実行可能な例です。1つを開いて「Start」を押し、コードを書く前に出力を確認してください。

• API経由で画像を比較、類似性スコアをJSONで取得

• 2つの画像の類似性を比較、パーセンテージ判定

• URLリストからオンライン上の重複画像を検出

• pHashとdHashを使用した一括画像ハッシュチェック

• スクリーンショットをベースラインと比較、変更をフラグ

最初の3つはimage-similarity-api-example.pyの関数として実装されているため、ローカルでも実行できます。

スケジュールのヒント： 自身の写真の再利用を監視するには、実行をタスクとして保存し（あなたの画像をsourceImageに設定）、スケジュールします。各実行で新しい比較行が追加されるため、単一のスナップショットではなく日付付きの履歴が得られます。

入力パラメータ

出力フィールド

比較ごとに1行。

Claude Cowork Desktop にインストール

Coworkはデスクトップアプリの自動化モードです。画像比較APIをツールとして提供するには、Apify MCPサーバーをコネクターとして追加します。

1. Claudeデスクトップアプリを開き、Settings > Connectors に移動します（または Settings > Developer > Edit Config で直接 claude_desktop_config.json を編集）。

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. このActorのみがプリロードされたApify MCPサーバーを追加します。

{
  "mcpServers": {
    "apify": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.apify.com/?tools=actors,docs,johnvc/image-similarity-api"
      ]
    }
  }
}

3. アプリを再起動します。Coworkが最初にツールを呼び出すときに、ブラウザでOAuthプロンプトを完了するか、コネクター設定にApify APIトークンを追加してOAuthをスキップします。

4. Coworkチャットでツールが利用可能であることを確認し、画像比較APIを実行するよう依頼します。

デスクトップアプリをダウンロードして無料トライアルを開始：https://claude.ai/referral/uIlpa7nPLg 詳細はこちら：https://docs.apify.com/platform/integrations/claude-desktop

Claude Code にインストール

Claude Codeはコマンドラインツールです。1つのコマンドでActorのMCPサーバーを追加します。

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/image-similarity-api"

ブラウザOAuthの代わりにトークンを使用する場合：

claude mcp add --transport http apify \
  "https://mcp.apify.com/?tools=actors,docs,johnvc/image-similarity-api" \
  --header "Authorization: Bearer YOUR_APIFY_TOKEN"

次に claude mcp list で確認するか、セッション内で /mcp を実行します。Claude Codeに画像比較APIを呼び出すよう依頼します。

Claude Codeを無料で試す：https://claude.ai/referral/uIlpa7nPLg Claude Code MCPドキュメント：https://code.claude.com/docs/en/mcp

Claude（ウェブサイト）にインストール

claude.aiでApifyをコネクターとして追加し、このActorのツールのみを有効にします。

1. Settings > Connectors > Browse connectors に移動し、Apify MCP server を検索します。インストールします（プロンプトが表示されたら有効化または更新）。

2. 接続時にApify APIトークンで認証し、ツール johnvc/image-similarity-api を有効にします。

3. 任意のチャットで、+ > Connectors を開いて Apify をオンにします。

4. または、Add custom connector を選択し、完全なMCP URL https://mcp.apify.com/?tools=actors,docs,johnvc/image-similarity-api を貼り付け、プロンプトが表示されたらOAuthを使用します。

5. Claudeに画像比較APIを実行するよう依頼します。

ウェブでClaudeを開く：https://claude.ai

Cursor にインストール

Cursorはプロジェクトファイル .cursor/mcp.json からMCPサーバーを読み取ります。

1. プロジェクト内で .cursor/mcp.json を作成します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/image-similarity-api"
    }
  }
}

2. ブラウザOAuthの代わりにトークン認証を使用する場合は、ヘッダーを追加します。

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com/?tools=actors,docs,johnvc/image-similarity-api",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

3. Cursor > Settings > MCP を開き、apify サーバーが接続されていることを確認します（緑のドット）。

4. ComposerまたはChatで、Cursorに画像比較APIを呼び出すよう依頼します。

Cursorを初めて使う方はこちら：https://cursor.com/referral?code=XQP4VBLI3NNX

ChatGPT にインストール

ChatGPTはデベロッパーモードを介してApify MCPサーバーに接続します（ChatGPT Pro、Plus、Business、Enterprise、Educationプランで利用可能）。

1. プロフィールアイコンをクリックし、Settings > Apps に移動します。Create app ボタンが表示されない場合は、Advanced settings を開いて Developer mode を有効にします。

2. Create app をクリックし、フォームに入力します。

   • Name: Apify

   • MCP Server URL: https://mcp.apify.com/?tools=actors,docs,johnvc/image-similarity-api

   • Authentication: OAuth

3. Create をクリックし、接続をApifyで承認します。

4. 会話でアプリを使用するには、チャット内で + をクリックし、Developer mode を選択して Apify を選択します。

詳細はこちら：https://docs.apify.com/platform/integrations/mcp

FAQ

2つの画像の類似性を比較するにはどうすればよいですか？ 1つの sourceImage と1つのエントリを targetImages に渡し、similarityScore を読み取ります。これは0から1の間の数値で、0.97はそのペアがほぼ確実に同じ画像であることを意味します。希望するカットオフ値に threshold を設定すると、Actorが isSimilar を設定します。

埋め込みスコアとpHashの違いは何ですか？ 埋め込みはCLIPビジョンモデルです。画像の中身を比較するため、トリミング、リサイズ、色変更、再エンコード後でもマッチングします。知覚ハッシュはピクセルの視覚的フィンガープリントを比較し、非常に低コストですが、大きな編集があると壊れます。both を実行すると、同じ行に意味的スコアと重複距離の両方が得られます。

URLリストからオンライン上の重複画像を見つけるにはどうすればよいですか？ 気になる画像を sourceImage に、候補を targetImages に配置し、both モードで実行します。isNearDuplicate がtrueの行はバイトレベルのコピーです。similarityScore が高くてもハッシュ距離が大きい行は、編集または再エンコードされたコピーです。

画像の著作権チェッカーとして使用できますか？ そのジョブのマッチング部分には使用できます。オリジナルの写真と、画像が再利用されたと思われるページのリストを渡すと、どの画像がどの程度一致するかを教えてくれます。法的判断は行いませんし、ウェブを検索することもありません。候補URLはあなたが提供します。

スクリーンショットの比較に使えますか？ はい、それは一般的な使用例です。ベースラインのスクリーンショットをソースとして保持し、新しいキャプチャをそれぞれ比較し、スコアがしきい値を下回ったらアラートを出します。小さなレイアウト変更には、通常ハッシュ距離の方がより敏感なシグナルです。

知覚ハッシュとは何ですか？ 知覚ハッシュは画像を短いフィンガープリントに縮約するため、視覚的に類似した画像は類似したフィンガープリントを生成します。2つのハッシュは、何ビット異なるかを数えることで比較します。これがこのActorが phashDistance および dhashDistance として返す距離です。チェックサムとは異なり、1ピクセルの変更で答えが完全に変わることはありません。

画像が読み込まれない場合はどうなりますか？ そのターゲットは独自の行として errorMessage が付加されて返され、残りの実行は継続します。無効なURLがあってもジョブ全体が失敗することはありません。

実行の料金はいくらですか？ 料金は Actor ページ に記載されており、比較ごとに課金されます。つまり10個のターゲットは10単位です。モデルスコアが不要な場合はハッシュ専用モードがより安価な方法です。README にコピーされた数字ではなく、そちらで最新の価格を確認してください。

関連検索

画像比較API, 画像類似度API, 重複画像検索, 重複画像ファインダー, 2枚の画像を比較して類似度を確認, phash, 知覚ハッシュ, 画像著作権チェッカー, スクリーンショット比較, 画像重複排除, AI画像比較, 重複写真検索, 画像ハッシュチェック, 視覚的類似検索

詳細

• Apify Store の Actor: https://apify.com/johnvc/image-similarity-api?fpr=9n7kx3

• 無料のApifyアカウント: https://apify.com?fpr=9n7kx3

• Apify Python クライアントドキュメント: https://docs.apify.com/api/client/python/

• Apify MCP ドキュメント: https://docs.apify.com/platform/integrations/mcp

• uv: https://docs.astral.sh/uv/

最終更新日: 2026.08.18