reddit-url-mentions

Reddit URL の言及

Frevana を通じて、特定の URL に言及している Reddit の投稿を確認します。

目的

このスキルは、1 つ以上の URL に関する Reddit 上の言及を検索するためのものです。

入力：

• targets（必須）— 絶対 URL の配列（最大 10 件）
• tag（任意）— Frevana から返される、ユーザー定義のタスク識別子（最大 255 文字）

出力：

• URL ごとの Reddit 上の言及結果を含む、検証済みのレスポンス JSON

このスキルはレスポンスが JSON であることを検証し、変更せずに返します。ユーザーが明示的に変換を依頼しない限り、返されたデータを書き換えたり、再構成したりしないでください。

このスキルに必要なもの

• ユーザーが指定する targets（URL の配列、最大 10 件）
• 任意の tag
• 環境変数の FREVANA_TOKEN、または今回の実行に対する明示的な --token による上書き
• curl
• bash
• python3

実行順序

リクエストをシンプルで確実なものにするため、次の手順を使用します。

1. ユーザーが少なくとも 1 つの対象 URL を指定していることを確認します。
2. 対象 URL を検証します。URL は最大 10 件で、それぞれが絶対 URL（http:// または https:// を含む）である必要があります。
3. 場当たり的な curl コマンドよりも、スクリプトを優先します。
4. まずスクリプトに FREVANA_TOKEN を読み取らせます。
5. 対話型シェルでの使用時に FREVANA_TOKEN がない場合、スクリプトは入力を求めてもかまいません。
6. 非対話型またはエージェントのワークフローでは、トークンがない場合は速やかに失敗させ、FREVANA_TOKEN を設定するか、--token を明示的に渡すようユーザーに伝えます。
7. 検証済みのレスポンス JSON を返します。全データが不要な場合は、ユーザーが実際に必要としているフィールドを要約します。
8. 必要に応じて、JSON をファイルにも保存します。

コマンド

対象 URL を指定した基本検索

bash <skill-path>/scripts/search_reddit_mentions.sh \
  --targets "https://example.com,https://example.org"

タグを指定する場合

bash <skill-path>/scripts/search_reddit_mentions.sh \
  --targets "https://example.com" \
  --tag "my-campaign-001"

出力をファイルに保存する場合

bash <skill-path>/scripts/search_reddit_mentions.sh \
  --targets "https://example.com,https://example.org" \
  --tag "my-campaign-001" \
  --output ./out/reddit-mentions-result.json

今回の実行に対してトークンを上書きする場合

bash <skill-path>/scripts/search_reddit_mentions.sh \
  --targets "https://example.com" \
  --token "your bearer token"

固定のリクエスト形式

スクリプトは次の形式のペイロードを送信します。

{
  "targets": ["https://example.com", "https://example.org"],
  "tag": "my-campaign-001"
}

レスポンス形式

API は、次のトップレベル構造を持つ JSON を返します。

{
  "version": "0.1.20210713",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.9068 sec.",
  "cost": 0.00024,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "uuid",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.8277 sec.",
      "cost": 0.00024,
      "result_count": 6,
      "data": { "...": "..." },
      "result": [
        {
          "type": "social_media_reddit_item",
          "page_url": "https://example.com",
          "reddit_reviews": [
            {
              "subreddit": "subreddit_name",
              "author_name": "author_nickname",
              "title": "Post title",
              "permalink": "/r/subreddit/comments/...",
              "subreddit_members": 2350423
            }
          ]
        }
      ]
    }
  ]
}

URL に関する Reddit 上の言及がない場合、reddit_reviews は null になります。

このスキルはレスポンスが JSON であることを検証し、変更せずに返します。

出力

• 成功時：スクリプトはレスポンス本文が JSON であることを検証し、標準出力に表示します
• --output を指定した場合：同じ JSON を指定されたファイルパスにも書き込みます
• 失敗時：スクリプトはレスポンス本文または解析エラーを表示し、ゼロ以外の終了コードで終了します

注意事項

• --targets を使って、少なくとも 1 つの対象 URL を指定する必要があります
• 対象 URL は 1 つの文字列引数内でカンマ区切りにする必要があります（例：--targets "https://a.com,https://b.com"）
• 各 URL は http:// または https:// を含む絶対 URL である必要があります
• 1 回のリクエストで指定できる対象 URL は最大 10 件です
• curl がない場合は処理を停止し、curl をインストールするようユーザーに伝えます
• python3 がない場合は処理を停止し、python3 をインストールするようユーザーに伝えます
• Bearer トークンをユーザーに表示しないでください
• reddit_reviews が null の場合、その URL への Reddit 上の言及はありません
• ユーザーが全データを求めていない限り、生の JSON をそのまま出力するのではなく、主な調査結果を要約します

プロンプトの例

中国語

• 「https://example.com が Reddit で言及されているか調べて」
• 「これらの URL の Reddit 上での言及状況を確認して：https://url1.com, https://url2.com」
• 「Reddit URL mentions API を呼び出して、生の JSON をファイルに保存して」

英語

• 「https://example.com が Reddit で言及されているか確認して」
• 「これらの URL に関する Reddit 上の言及を検索して：https://url1.com, https://url2.com」
• 「Reddit URL mentions API に問い合わせて、生の JSON をファイルに保存して」