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 - 限定在指定的 subreddit 中
• sort - relevance、hot、new、top
• time - hour、day、week、month、year、all

返回：

• 帖子标题和内容
• 作者和 subreddit
• 点赞数和评论数
• 帖子 URL

在 Subreddit 中搜索

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. 使用 x402.fetch 调用端点，URL 必须使用发现结果或上方快速参考表中的准确 URL
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"}
)

社群情绪分析

• 找出相关 subreddit
• 搜索有关主题的讨论
• 获取热门帖子的评论
• 综合分析整体情绪倾向

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