linkfox-ruiguan-copyright-detection

Ruiguan Copyright Detection

このスキルでは、画像の著作権検出方法を説明します。EC の出品者やデザイナーが、画像を使用する前に著作権侵害の潜在的なリスクを特定できるよう支援します。

主な概念

著作権検出では、指定された画像と、著作権登録済みの作品のデータベースを照合します。システムは、視覚的に類似した著作権保護画像と、類似度スコア、権利者情報、TRO（仮差止命令）の訴訟履歴、レーダーによる侵害評価などの主なリスク指標を返します。

類似度：入力画像が著作権保護作品にどの程度一致するかを示す小数文字列（例："0.85"）です。値が高いほどリスクが高いことを示します。

レーダー検出：侵害の有無を二値で判定する（1 = 侵害あり、0 = 侵害なし）追加の分析レイヤーです。有効にすると、各結果にこの二次評価が含まれます。

TRO 履歴：TRO（仮差止命令）は、著作権の執行で一般的に用いられる法的手段です。TRO 履歴のフラグが付いた結果は、権利者が過去に法的措置を取ったことを示し、リスクが高まっていることを意味します。

パラメーター

パラメーター	型	必須	デフォルト	説明
imageUrl	string	はい	-	著作権侵害を確認する画像の URL（最大 1000 文字）
topNumber	integer	いいえ	100	返す結果の件数（最小：10、最大：200）
enableRadar	boolean	いいえ	true	レーダーによる侵害検出を有効にするかどうか

パラメーターのガイドライン

1. imageUrl：一般にアクセス可能な画像 URL を指定する必要があります。一般的な画像形式に対応しています。URL は 1000 文字以内にしてください。
2. topNumber：返す著作権保護作品の一致件数を指定します。簡易チェックには小さい数（例：10～20）を、詳細な監査には最大値（200）を使用してください。
3. enableRadar：true に設定すると、各結果にレーダーによる侵害判定が含まれます。包括的な分析を行う場合は有効のままにしてください。類似度のみのスキャンをより高速に行えば十分な場合に限り、無効にしてください。

呼び出し方法

• API エンドポイント：POST /ruiguan/copyrightDetection（全パラメーター／レスポンス／エラーコードについては references/api.md を参照）
• Python スクリプト：python scripts/ruiguan_copyright_detection.py '<JSON パラメーター>' [--inline]
• コスト制約：このツールは計算リソースを消費します。同一セッション内で同じパラメーターの組み合わせを指定した呼び出しは、デフォルトで 1 回のみです。スクリプトには 24 時間のローカルキャッシュがあります。失敗または空の結果が返された場合、自動的にキーワードを変えたり、ページをめくったり、郵便番号を変えたりして連続して試行してはいけません。検索を続ける必要がある場合は、追加のコストが発生することを事前にユーザーに説明してください。

出力方針（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-ruiguan-copyright-detection-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリで、Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動でまとめられます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーにしてください）
• レスポンス本文が 8 KB 以下：ファイルに保存した後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える：ファイルに保存した後、stdout には概要のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最も大きなリストフィールドの長さと先頭 3 件のサンプル）
• --inline を付けると、完全な内容を stdout に強制出力します（同様にファイルにも保存されます）

データの読み取りに関する推奨事項：まず概要を確認し、それで十分か判断してください。具体的なフィールドが必要な場合は、保存済みの json ファイルから jq または ConvertFrom-Json を使って必要な部分を抽出し、JSON 全体がコンテキストに入らないようにしてください。

認証および計算リソースの問題の解決

次の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高が不足しているというレスポンス：メッセージに「算力余额不足／计费不足／余额不足／quota exceeded／insufficient balance／套餐到期／需充值／请充值」、または同様の意味の内容が含まれています。

ローカル画像のアップロード

このツールでは、一般にアクセス可能な画像 URL が必要です。ユーザーがローカル画像のファイルパス（例：C:\Users\...\photo.png、/home/.../image.jpg）を指定した場合は、先にアップロードして公開 URL を取得する必要があります。

アップロードスクリプトを実行します：

python scripts/upload_image.py /path/to/local/image.png

スクリプトは公開 URL を返します。この URL は 24 時間有効で、画像 URL パラメーターに使用できます。

使用例

1. 1 枚の画像の基本的な著作権チェック ユーザー：「この画像に著作権上の問題がないか確認してください：https://example.com/my-image.jpg」 アクション：指定された URL を imageUrl に設定し、ほかのパラメーターはデフォルト値を使用して呼び出します。

2. 結果を絞ったクイックスキャン ユーザー：「この商品画像の著作権を簡単にスキャンしてください。上位の一致結果だけ必要です：https://example.com/product.png」 アクション：結果をより速く取得できるよう、topNumber を 10 に設定して呼び出します。

3. 最大件数での徹底的な監査 ユーザー：「このデザインの著作権を徹底的に監査してください：https://example.com/design.jpg」 アクション：最も包括的にスキャンできるよう、topNumber を 200 に設定して呼び出します。

4. 類似性のみのチェック（レーダーなし） ユーザー：「著作権のある作品との類似性だけをチェックしてください。詳細な侵害分析は必要ありません：https://example.com/photo.jpg」 アクション：enableRadar を false に設定して呼び出します。

5. 一括チェック（複数画像） ユーザー：「この 3 枚の画像の著作権を確認してください：url1、url2、url3」 アクション：各画像 URL に対して API を 1 回ずつ呼び出し、結果をまとめます。

表示ルール

1. データを明確に提示する：検出結果を構成の整った表で示します。表示する主な列には、類似度スコア、権利者、著作権コード、レーダー結果、TRO 履歴、著作権の出典リンクを含めます。
2. リスクの高い結果を強調する：類似度が高い場合（例：>= 0.80）、またはレーダー検出で侵害の可能性が示された場合（subRadarResult = 1）、該当項目を高リスクとして明確に示します。
3. TRO に関する警告：troCase または troHolder が true の場合、権利者に関連する既存の TRO 訴訟履歴について、ユーザーに目立つ形で警告します。
4. 画像プレビュー：path または pathThumb の URL がある場合、それらの URL で著作権のある作品のサムネイルプレビューを表示できることを伝えます。
5. 件数の通知：一致した結果の件数を total でユーザーに伝えます。結果が多数返された場合は、最も関連性の高い項目（類似度が最も高いもの）を先に表示します。
6. エラー処理：リクエストが失敗した場合は理由を説明し、画像 URL が一般公開されていて正しい形式であることを確認するよう提案します。
7. 法的助言はしない：検出結果を事実に基づいて提示します。法的な結論は示さず、著作権について確定的な評価が必要な場合は、法律の専門家に相談するよう勧めます。

重要な制限事項

• 画像 URL が必要：このツールが受け付けるのは画像 URL のみで、ローカルファイルのアップロードには対応していません。画像は一般公開されている必要があります。
• URL の長さ：画像 URL は 1000 文字を超えてはなりません。
• 結果の上限：1 回のクエリで返される結果は最大 200 件です。
• 検出範囲：結果は、検出サービスが管理する著作権のある作品のデータベースに限定されます。

ユーザー表現とシナリオのクイックリファレンス

該当 — 画像の著作権リスク評価：

ユーザーの発言	シナリオ
「この画像に著作権上の問題がないか確認してください」	基本的な著作権検出
「この画像は安全に使用できますか」	侵害リスクの確認
「類似する著作権のある画像を探してください」	著作権の類似性検索
「この画像には TRO のリスクがありますか」	TRO 訴訟リスク分析
「この画像の著作権者は誰ですか」	権利者の照会
「商品画像の著作権を監査してください」	著作権コンプライアンスの一括チェック
「このデザインは独自のものですか、それとも複製ですか」	独自性の確認

該当しない — 画像の著作権検出以外の要件：

• 商標または特許の検索
• テキストまたは音楽の著作権チェック
• 画像の編集または加工
• 著作権以外の目的での画像の逆検索
• 法的助言または訴訟戦略

コンピューティングリソースの消費ルール

レーダー検出を有効にした場合は 71 コンピューティングリソースを消費し、無効にした場合は 36 コンピューティングリソースを消費します。

重要：このスキルは大量のコンピューティングリソースを消費します。呼び出し回数が5回を超える場合は、必ずAskUserQuestionを使ってユーザーに再確認してください。すでに消費したコンピューティングリソースと、続けて呼び出した場合に予想される消費量を明確に伝え、続行するかどうかをユーザー自身に判断してもらってください。

フィードバック：

次のいずれかに該当する場合は、Feedback API を通じてフィードバックを自動検出し、報告してください。

1. このスキルで説明されている機能や目的が、実際の動作と一致しない
2. スキルの結果がユーザーの意図と一致しない
3. ユーザーがこのスキルへの不満や称賛を表明した
4. 改善できると思われることがある

references/api.mdに記載されているとおりにフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

より高品質でプロフェッショナルな越境 EC スキルを利用するには、LinkFox Skillsを設定してください。