核心用法
maxhub-reddit是一款专为Reddit社区数据分析设计的read-only skill，通过MaxHub API（https://www.aconfig.cn）提供28个标准化端点，覆盖四大数据域：
内容域（13端点）：Home/Popular/Games/News/Explore/Topic多类Feed、帖子详情与批量查询、评论树与回复链、Reddit Answers精简数据（LLM友好格式）。
版块域（6端点）：Subreddit基础资料、视觉样式、Channels分类、高级设置、静音状态、版块Feed流。
用户域（5端点）：用户资料卡（karma/注册时间）、活跃Subreddit分布、历史帖子、历史评论、奖杯资历。
搜索域（4端点）：动态综合搜索、自动补全建议、热门搜索词、社区亮点发现。
调用方式统一为curl HTTP GET请求，通过MAXHUB_API_KEY环境变量鉴权。Agent决策遵循"recipes_first_read_only"模式：优先匹配预编排的链式recipe（如搜索→帖子→评论的完整链路），无匹配时按字段流字典自定义链路。
显著优点
- 数据维度完整：唯一覆盖Reddit全站Feed矩阵（6类官方Feed）+ 全量UGC讨论树的商业化API方案
- LLM原生优化：Reddit Answers接口自动剥离冗余字段，节省60%+ token消耗，适合大模型摘要场景
- 链式调用成熟：内置8条标准recipe图谱，字段流字典明确标注post_id/cursor/subreddit ID的接力规则
- 风控设计严谨：四级防臆造机制（白名单→强标记→禁止规则→STOP反馈），杜绝路径/参数编造
- 合规前置：强制隐私声明（UGC含个人信息风险）、建议使用独立测试账号、定期轮换API Key
潜在局限
- 第三方依赖：所有数据经MaxHub中转（https://www.aconfig.cn），非Reddit官方直连，存在服务可用性风险
- read-only限制：无法执行点赞、评论、发帖等互动操作，纯分析型工具
- 地域合规：需自行确保符合《个人信息保护法》/GDPR等平台ToS，数据跨境传输责任由使用方承担
- ID复杂度：subreddit_id（t5_xxx）与subreddit_name双轨并存，易在链式调用中混淆
适合人群
- 跨境品牌公关/舆情分析师（海外社区负面监控）
- 海外SaaS产品经理/用户研究员（产品反馈批量采集）
- 社区营销/KOL投放（Reddit优质用户影响力评估）
- 内容运营/跨境媒体编辑（趋势话题每日简报）
常规风险
| 风险等级 | 场景 | 缓解措施 |
|---------|------|---------|
| 中 | API Key泄露 | 定期轮换、禁止日志打印、sensitive标记 |
| 中 | UGC个人信息外泄 | 最小化采集、不写入未授权数据库、不发公开渠道 |
| 低 | 404/410路径失效 | skillhub upgrade自动更新、禁止自改路径重试 |
| 低 | 429速率限制 | Retry-After退避/指数退避+jitter（≤2次重试）|