linkfox-ruiguan-gun-parts-search

Ruiguan ポリシー遵守画像検出

このスキルでは、Ruiguan ポリシー遵守検出ツールを使用して、商品画像に潜在的なポリシー違反がないかを特定する方法を説明します。既知の禁止商品データベースを対象に、画像ベースの類似検索を行います。

基本概念

Ruiguan ポリシー遵守画像検出は、画像ベースのコンプライアンス審査サービスです。商品画像の URL を指定すると、ポリシー違反が確認されている商品のデータベースから、見た目が類似する商品を検索します。このツールは、一致した違反商品を視覚的類似度の高い順に返します。

類似度スコア（コサイン）：0〜1 の値です。値が高いほど、既知の違反商品との視覚的な類似度が高いことを示します。スコアが 1.0 に近い場合、その商品画像はフラグが付けられた違反商品とほぼ同一です。

パラメーターガイド

パラメーター	型	必須	説明	例
画像 URL	imageUrl	はい	確認する商品画像の URL（最大 1000 文字）	https://example.com/product.jpg

重要な注意事項：

• 画像 URL は一般公開されている必要があります
• 一般的な画像形式（JPG、PNG など）に対応しています
• URL は 1000 文字を超えてはいけません

レスポンスフィールド

フィールド	API 名	説明
一致総数	total	見つかった違反レコードの一致件数
違反リスト	data	一致した違反商品の配列
違反画像	pdImgOssUrl	一致した違反商品の画像 URL
類似度スコア	cosine	入力画像と違反商品の類似度（0〜1）
商品タイトル（英語）	pdTitle	一致した違反商品の英語タイトル
商品タイトル（中国語）	pdTitleCHNCensored	一致した違反商品の中国語タイトル
検出 ID	detectId	この検出セッションの一意な識別子
トークンコスト	costToken	このリクエストで消費したトークン数

呼び出し方法

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

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

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

データの読み取りに関する推奨事項：まず概要を確認して十分かどうかを判断してください。具体的なフィールドが必要な場合は、JSON 全体をコンテキストに取り込まないよう、保存済みの json ファイルから jq または ConvertFrom-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 時間有効）を返します。

使用例

1. 単一の商品画像の基本的なコンプライアンスチェック

Check this product image for policy compliance: https://example.com/images/product-123.jpg

2. 複数の商品画像の一括チェック

Please scan these product images for potential policy violations:
- https://example.com/images/item-a.jpg
- https://example.com/images/item-b.jpg

3. 出品前のコンプライアンス審査

Before I list this product, can you check if the image triggers any policy flags?
Image: https://example.com/new-product.png

表示ルール

1. 結果を分かりやすい表で表示する：一致した違反項目ごとに、画像、類似度スコア、商品タイトルを表示します
2. 類似度の高い一致を強調する：コサインスコアが0.8を超える場合は、注意が必要と思われる強い一致として明確に示します
3. 違反画像を含める：結果にpdImgOssUrlが含まれる場合、一致した違反画像を表示し、ユーザーが目視で比較できるようにします
4. スコアの解釈：類似度スコアの意味を必ず説明します。値が高いほど、既知の違反により近いことを示します
5. エラー処理：クエリが失敗した場合は、問題を説明し、画像URLが有効で一般公開されているか確認するよう提案します
6. 法的助言を行わない：検出結果は事実に基づいて提示し、法的な判断は行いません。プラットフォームのポリシーを確認するようユーザーに伝えます

重要な制限事項

• 画像のみを検出：このツールは画像URLのみを対象とし、テキストによる説明や商品メタデータは分析しません
• URLへのアクセス性：検出サービスから画像URLに一般公開でアクセスできる必要があります
• URLの長さ制限：画像URLは1000文字以下である必要があります
• 類似度に基づく判定：結果は視覚的な類似度に基づいており、ポリシーに関する確定的な判定ではありません

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

該当するケース — 画像ベースの商品ポリシー遵守チェック：

ユーザーの発言	シナリオ
"この商品画像にコンプライアンス上のリスクがあるか確認して"	単一画像のコンプライアンスチェック
"商品画像をスキャンしてポリシー違反がないか確認して"	複数画像のコンプライアンススクリーニング
"この画像は販売禁止商品としてフラグが付いていますか"	特定の違反に関する問い合わせ
"出品画像のポリシーリスクを事前審査して"	出品前のコンプライアンス監査
"この商品画像に類似する違反を見つけて"	類似度に基づく違反検索
"この商品を安全に出品できますか"	コンプライアンスリスクの事前チェック
"この画像が規約違反かどうか検出して"	単一画像のコンプライアンス検出

該当しないケース — 画像ベースのポリシー遵守検出の範囲外：

• テキストベースの商品コンプライアンス分析
• 一般的な商品カテゴリの分類
• 知的財産権／商標権の侵害
• 特許または著作権の検出（ほかのRuiguanスキルを使用してください）

計算リソースの消費ルール

計算リソースを31消費します。

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

フィードバック：

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

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

references/api.mdの指定に従ってFeedback APIを呼び出してください。ユーザーの作業を中断しないでください。

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