核心用法
deso-research 是一款面向去中心化社交网络（DeSo）的内容研究工具，通过封装 deso-ag CLI 实现跨平台数据聚合。核心工作流包括：
1. 内容搜索（search）：支持关键词检索、多词 AND 匹配、指定平台/频道筛选，默认输出 compact JSON 格式便于 AI 解析；
2. 趋势洞察（trending）：抓取各平台热门内容，可按时间范围（24h/48h/week）和平台过滤；
3. 热词提取（terms）：基于互动量加权计算讨论热词，输出结构化 JSON 供主题聚类分析；
4. 频道浏览（channels）：专用于 Farcaster 频道发现。
工具采用环境变量管理 API 密钥（Neynar、Bluesky），无密钥时自动降级运行，确保基础功能可用。
显著优点
- 多平台一站式覆盖：同时对接四大主流 DeSo 协议，避免研究者分别对接不同 API 的繁琐；
- AI 原生输出格式：
compact模式返回预计算互动分数（likes + reposts×2 + replies）的标准化 JSON，大幅降低下游分析成本； - 渐进式权限设计：核心功能零配置可用，高级功能按需申请免费 API key，降低入门门槛；
- 实时性与灵活性：支持按时间窗口、排序方式（engagement/recent/relevance）精细调控数据粒度。
潜在缺点与局限性
- 数据完整性依赖第三方：Farcaster 搜索/趋势需 Neynar API key，Bluesky 搜索需账号密码，无密钥时对应平台数据缺失；
- Nostr 网络不稳定：中继节点分散，可能出现超时或数据不一致，需重试机制兜底；
- 无历史数据回溯：仅支持近期时间窗口（最长一周），无法获取长期趋势；
- 分析深度有限：工具仅提供原始数据聚合，主题建模、情感分析等需用户自行实现；
- 速率限制未明确：重度使用可能触发 API 限流，官方建议自建基础设施规避。
适合的目标群体
- Web3 研究员与分析师：追踪加密社区舆论热点、监测项目声量；
- 产品经理与运营：洞察用户反馈、识别 KOL 观点、竞品动态监控；
- 内容创作者与记者：快速获取一手社区讨论素材，验证叙事趋势；
- 开发者与协议团队：评估功能迭代在社区中的反响，收集改进建议。
使用风险
- 网络依赖风险：核心功能完全依赖外部 API 可用性，任一平台服务中断将直接影响数据完整性；
- 依赖项安全风险：
deso-agnpm 包为第三方实现，需持续关注其安全更新； - API 密钥泄露风险：Bluesky 使用应用密码而非 OAuth，存在误配置泄露可能；
- 数据合规边界：抓取公开社交内容虽无 PII 风险，但需遵守各平台 ToS，商业用途建议二次确认。