Reddit 数据 Skill

通过 UnifAPI 读取公开 Reddit 数据的确定性读取路径。这是一个 Data Skill：它本身不运行营销任务——它点名具体的 reddit/... 操作、响应形态，以及真实的覆盖限制，好让任何 以社区为先的工作流（社交聆听、客户之声）都从一份已知、诚实的配方 读取，而不必每次重新探索这片接口。

只读——眼睛，而非双手。它调研公开 Reddit 数据并返回 带引用的记录；它绝不发帖、评论或投票，而 UnifAPI 也绝不持有 Reddit 凭据。

使用 unifapi 技能获取实时证据

通过共享的 unifapi 技能连接一次（OAuth MCP），然后调用下文的 操作。Reddit 的公开接口没有关键词搜索，所以发现是由种子驱动的 ——在输出中说明这一点。保留任何 billing 元数据，以便输出 能说明记录成本。

响应契约

单实体端点在 data 中返回对象：

{
  "request_id": "unif_...",
  "data": {},
  "billing": { "records_charged": 1, "balance_remaining": 99 }
}

列表端点在 data 中返回数组，外加 pagination：

{
  "request_id": "unif_...",
  "data": [],
  "pagination": { "has_more": false, "next_cursor": null },
  "billing": { "records_charged": 1 }
}

当 pagination.has_more 为 true 时，把 pagination.next_cursor 作为下一次 请求的 cursor 传入。报告成本时始终保留 billing。

核心操作

需要这里未列出的字段？在调用前用 unifapi 技能的 get_operation 读取 确切 schema——但要从这张表里挑操作，别盲目地去 发现。

工作流

确定性的配方。挑选与任务匹配的那一个；每一个都精确点名 要调用什么。

1. **播下社区种子。**Reddit 没有关键词搜索，所以点名受众所在的子版块， 并调用 reddit/subreddits/{name} 获取 subscribers_count、active_count、is_nsfw，以及 description 中的规则。
2. **发现帖子。**扫描 reddit/feed/popular、reddit/feed/news 和 reddit/feed/home，外加 reddit/trending-searches，保留那些 subreddit 字段与你的种子匹配的帖子——这就是在没有按子版块信息流的情况下 找到社区帖子的方法。
3. **挖掘一个帖子。**有了帖子 id，调用 reddit/posts/{id} 取帖子， 调用 reddit/posts/{id}/comments 取评论树；捕获被点赞 （score）的逐字语言。用 next_cursor 翻页。
4. **追踪活跃用户。**调用 reddit/users/{username} 获取 karma，再用 .../posts 和 .../comments 看一位活跃成员在这个细分领域里 贡献了什么。
5. **标注触达安全性。**在建议任何参与之前，先从 description 和 is_nsfw 读取每个子版块的规则。
6. **为一切标注引用。**每一句引语都回溯到它的帖子或评论； 坦白说明覆盖是种子驱动的、并非穷尽，并报告 billing.records_charged。

形态说明

• RedditSubreddit——以 {name} 为键。subscribers_count、 active_count、is_nsfw、description（承载规则）、prefixed_name （r/...）。
• RedditPost——title、url、text、created_at、subreddit、 is_stickied、is_locked、is_nsfw。用 subreddit 字段把 信息流结果过滤回某个社区。
• RedditComment——text、score（点赞数）、author_name、is_locked。
• RedditUser——name、karma_total、karma_from_posts、 karma_from_comments、is_verified、is_employee。

坑点

• **没有关键词搜索。**你无法按词查询 Reddit——发现来自 全局的 feed/* 端点、trending-searches，以及你已经点名的 子版块/用户。在简报中说明这一点。
• 没有按子版块的帖子信息流。reddit/subreddits/{name} 只返回画像 与规则；要读一个社区的帖子，按 subreddit 字段过滤全局信息流、 从一个已知帖子 id 出发，或读取活跃用户的帖子。
• 余额过低会无声地截断列表页：检查 billing.truncated_due_to_balance——为 true 时该页是不完整的。

输出

返回调用方工作流所需的记录，每条都引用到它的帖子或 评论，外加一行成本说明（records_charged）。当本技能被直接 使用时，默认输出一份紧凑的社区简报：

**r/{subreddit}** — {subscribers} subscribers, {active} active. Recurring questions: {themes}. Verbatim: "{quote}" ({score} upvotes). Outreach rules: {note}. Coverage: seed-driven. Evidence: {URLs}. Records: ~{N}.

相关技能

• reddit-community-research（Lead & Company Research）——把这条读取路径转化为一张结构化的社区图谱。
• social-listening-brief（Social Listening）、customer-research——在 Reddit 读取之上的聆听与客户之声工作。
• unifapi——共享的数据技能：连接 MCP，并用 get_operation 查阅确切 schema。