研报客研究报告搜索下载

要解决的问题

当工程师需要把研究报告接入自动化流程时，手动查找、确认机构与日期、判断可用格式、反复下载会打断工作流。这个技能把研报客的搜索与下载拆成两个明确动作：先用关键词拿到结构化报告信息，再按需获取源文件。

工作方式

• 搜索调用 search 能力，无需 API Key，可按标题或全文检索，并支持 --org、--report-type、--stock、日期、页数等筛选；结果按发布时间倒序，最多返回 500 条。
• 搜索结果包含 uuid、title、url、time、pagenum、org_name、rtype_name、content、formats 等字段，可直接用于判断报告是否匹配需求，也可结合 content 做投研分析。
• 下载调用 download 能力，需要 API Key，使用报告 uuid 请求 pdf、doc 或 ppt 格式；若 formats 不包含目标格式，会返回格式不可用错误。
• 下载返回字段包含标题、原始文件名、格式和链接有效期；下载链接 60 秒内有效，需要及时拉取。
• 计费按报告计：每份报告首次下载消耗 10 个豆，已购买后可重复下载免费。

适用边界

搜索适合批量筛选和初步分析；下载适合已经确认要保存源文件的场景。它不提供报告解析、翻译或自动投研结论生成等额外能力，也不保证所有报告都支持 DOC/PPT。使用下载时应注意 API Key、余额、限频、UUID 和格式可用性。