social-intelligence

x402 API によるソーシャルインテリジェンス

停止 — API を呼び出す前にお読みください。 enrichx402.com のエンドポイントは、各プロバイダーのネイティブ API とは異なります。すべてのパスは https://enrichx402.com/api/{provider}/{action} の形式を使用します。必ず次のいずれかを行ってください。

1. 以下のクイックリファレンステーブルから URL を正確にコピーする、または
2. x402.discover_api_endpoints(url="https://enrichx402.com") を実行して正しいパスを取得する

**パスを推測すると、**405 エラー（パスが誤っている場合）または 404 エラー（/api/ プレフィックスがない場合）が発生します。

x402 で保護されたエンドポイントを通じて、X/Twitter（Grok 経由）と Reddit にアクセスします。

セットアップ

インストールとウォレットの設定については、rules/getting-started.md を参照してください。

クイックリファレンス

タスク	エンドポイント	価格	説明
X の投稿を検索	https://enrichx402.com/api/grok/x-search	$0.02	キーワードでツイートを検索
X のユーザーを検索	https://enrichx402.com/api/grok/user-search	$0.02	条件に合うユーザーを検索
ユーザーの投稿を取得	https://enrichx402.com/api/grok/user-posts	$0.02	ユーザーの最近の投稿
Reddit を検索	https://enrichx402.com/api/reddit/search	$0.02	Reddit の投稿を検索
コメントを取得	https://enrichx402.com/api/reddit/post-comments	$0.02	投稿へのコメント

使用方法については、rules/rate-limits.md を参照してください。

Grok 経由の X/Twitter

投稿を検索

キーワードで X の投稿を検索します。

x402.fetch(
  url="https://enrichx402.com/api/grok/x-search",
  method="POST",
  body={
    "query": "AI agents"
  }
)

パラメーター：

• query - 検索キーワード（必須）

返される内容：

• 投稿のテキストと投稿者情報
• エンゲージメント指標（いいね、リツイート、返信）
• タイムスタンプと URL
• メディアの添付ファイル

ユーザーを検索

条件に合う X ユーザーを検索します。

x402.fetch(
  url="https://enrichx402.com/api/grok/user-search",
  method="POST",
  body={
    "query": "AI researcher San Francisco"
  }
)

返される内容：

• ユーザー名と表示名
• 自己紹介／説明
• フォロワー数／フォロー数
• 認証状況
• プロフィールへのリンク

ユーザーの投稿を取得

特定のユーザーの最近の投稿を取得します。

x402.fetch(
  url="https://enrichx402.com/api/grok/user-posts",
  method="POST",
  body={
    "username": "elonmusk"
  }
)

パラメーター：

• username - @ を含まない X のユーザー名（必須）

返される内容： エンゲージメント指標をすべて含む最近の投稿。

Reddit

投稿を検索

Reddit の投稿を検索します。

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={
    "query": "best programming languages 2024"
  }
)

パラメーター：

• query - 検索語（必須）
• subreddit - 特定のサブレディットに限定
• sort - relevance、hot、new、top
• time - hour、day、week、month、year、all

返される内容：

• 投稿のタイトルと内容
• 投稿者とサブレディット
• アップボート数とコメント数
• 投稿 URL

サブレディット内を検索

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={
    "query": "typescript vs javascript",
    "subreddit": "programming",
    "sort": "top",
    "time": "year"
  }
)

投稿へのコメントを取得

Reddit の投稿からコメントを取得します。

x402.fetch(
  url="https://enrichx402.com/api/reddit/post-comments",
  method="POST",
  body={
    "postUrl": "https://reddit.com/r/programming/comments/abc123/..."
  }
)

返される内容：

• コメントのテキストと投稿者
• アップボート数／ダウンボート数
• 返信スレッド
• コメントのタイムスタンプ

ワークフロー

標準

1. （任意）残高を確認します：x402.get_wallet_info
2. エンドポイントを検出します（初回取得前に必須）： x402.discover_api_endpoints(url="https://enrichx402.com")
3. エンドポイントのスキーマを確認します：x402.check_endpoint_schema(url="...") を使ってパラメーターと料金を確認します
4. 検出結果または上記のクイックリファレンステーブルに記載された URL を正確に使い、x402.fetch でエンドポイントを呼び出します
5. 結果を解析して提示します

ブランドのモニタリング

• （任意）残高を確認します：x402.get_wallet_info
• X でブランドへの言及を検索します
• Reddit で関連する議論を検索します
• 感情と主な言及を要約します

x402.fetch(
  url="https://enrichx402.com/api/grok/x-search",
  method="POST",
  body={"query": "YourBrand OR @YourBrand"}
)

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={"query": "YourBrand", "sort": "new"}
)

競合調査

• Reddit で競合他社のレビューを検索します
• X で競合他社への言及を検索します
• よくある不満と称賛を分析します

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={"query": "competitor name review", "sort": "top", "time": "year"}
)

インフルエンサーの発掘

• 条件を定義します（トピック、フォロワー数の範囲）
• 条件に合うユーザーを検索します
• 有力候補の最近の投稿を取得します

x402.fetch(
  url="https://enrichx402.com/api/grok/user-search",
  method="POST",
  body={"query": "tech blogger 100k followers"}
)

コミュニティの感情分析

• 関連するサブレディットを特定します
• トピックに関する議論を検索します
• 上位の投稿からコメントを取得します
• 全体的な感情をまとめます

x402.fetch(
  url="https://enrichx402.com/api/reddit/search",
  method="POST",
  body={"query": "new feature name", "subreddit": "relevant_community", "sort": "hot"}
)

x402.fetch(
  url="https://enrichx402.com/api/reddit/post-comments",
  method="POST",
  body={"postUrl": "https://reddit.com/..."}
)

レスポンスデータ

X/Twitter の投稿フィールド

• text - 投稿内容
• author - ユーザー名、表示名、認証状況
• metrics - いいね、リツイート、返信、引用、表示回数
• createdAt - タイムスタンプ
• url - 投稿へのリンク
• media - 添付された画像／動画

X/Twitter User Fields

• username - Handle without @
• displayName - Full name
• description - Bio
• followers / following - Counts
• verified - Verification status
• profileImageUrl - Avatar

Reddit Post Fields

• title - Post title
• selftext - Post body (for text posts)
• author - Username
• subreddit - Subreddit name
• score - Upvotes minus downvotes
• numComments - Comment count
• url - Link to post
• createdUtc - Timestamp

Reddit Comment Fields

• body - Comment text
• author - Username
• score - Net upvotes
• replies - Nested replies
• createdUtc - Timestamp

Cost Estimation

Task	Calls	Cost
Quick X search	1	$0.02
User profile + posts	2	$0.04
Reddit thread + comments	2	$0.04
Full monitoring scan	4-6	$0.08-0.12