Gangtise 提取文件列表 — Ganttise 提取文件列表

搜索 鉴权

在 scripts/.authorization 文件中添加

{ "访问Key": "", "secret访问Key": "" }

或者添加全局环境变量GTS_访问_KEY和GTS_SECRET_KEY

导出 GTS_访问_KEY= 导出 GTS_SECRET_KEY=

概览

该技能会查询 Gangtise 文件中心，检索多种文档类型，例如研究报告、公司公告、会议纪要、首席观点与投研日程（路演、调研、线下策略会、论坛）等。它会返回文件 ID，并附带关键元数据与简短摘要；这些命中结果基于检索匹配与字段归纳，强调专业性、准确性与覆盖全面，同时提供按“类型 + ID”下载完整文件的方法。注意：由于 API 限制，大多数结果最多限制为 100 条；多数情况下建议将结果数量限制在 10 条以内。

使用场景：

你需要按类型、日期、证券或其他元数据来定位、筛选或整理文档。 你想先构建一个候选文档列表（例如某只股票的近期报告、某段时间内的全部公告）。 你计划下载完整文件并在本技能之外处理（例如后续解析或单独阅读）。

与其他技能的区别：

当你主要关心的是文本内容本身（用于总结、问答、抽取论点等），并且不需要浏览长文件列表时，优先使用 gangtise-kb。

（中文说明：gangtise-file 更像"文件目录/索引"，解决"有哪些文件、ID 是什么、按条件筛一批出来"的问题；真正看内容、抽段落建议用 gangtise-kb。）

各文档类型的主脚本用于执行检索并返回文件列表；部分参数提供枚举值脚本（如行业、机构等），调用前可先执行对应脚本获取可选值。无枚举值接口的参数（如关键词、证券、日期等）会由后端智能匹配，直接传入用户意图相关文本即可。证券代码需传入标准格式（如 000001.SZ）。

所有脚本都具有 -d / --下载 布尔型参数，用于判断在检索后自动下载对应文件至本地。一般来说用户不需要这个参数，除非用户明确要求下载文件。

所有脚本都具有-sd和-ed参数，使用时注意今天的年份和日期！

调用对应脚本前，请先查看对应脚本的调用指导文档，了解更多参数的含义和使用方法。

• 从研究报告检索

按关键词、证券、日期、券商、行业、研报类别、语义标签、评级/评级变动、页数范围、来源类型等条件检索研究报告。

重要说明：试用账号只能查询一个月内的研报（以接口权限校验为准）。

示例（关键词"比亚迪"，限定时间范围与数量）：

python3 scripts/报告.py -k 比亚迪 -sd 2026-01-01 -ed 2026-12-31 -l 20

行业、机构枚举值可通过 scripts/获取_industries.py、scripts/获取_institutions.py 获取。详见 研究报告调用指导。

• 外资研报检索

按关键词、证券、日期、券商、行业、区域、研报类别、语义标签、评级/评级变动、页数范围等条件检索外资研报列表。境外证券代码格式如 UBER.N。重要说明：试用账号只能查询一个月内的外资研报（以接口权限校验为准）。

示例（关键词 + 时间范围）：

python3 scripts/foreign_报告.py -k 自动驾驶 -sd 2026-02-01 -ed 2026-03-30 -l 20

行业、券商、区域枚举值可通过 scripts/获取_industries.py、scripts/获取_institutions.py、scripts/获取_regions.py 获取。详见 外资研报调用指导。

• 从公司公告检索

按证券、关键词、日期等条件检索公司公告。

示例（证券 + 关键词 + 时间）：

python3 scripts/announcement.py --securities 000858.SZ -k 业绩 -sd 2026-01-01 -ed 2026-12-31

详见 公司公告调用指导。

• 从会议纪要检索

按关键词、证券、机构、行业、来源类型、会议类别/市场/参会人角色等条件检索会议纪要。

示例（关键词 + 会议类别）：

python3 scripts/summary.py -k 锂电 --category_列出 earningsCall -l 20

行业、机构枚举值可通过 scripts/获取_industries.py、scripts/获取_institutions.py 获取。详见 会议纪要调用指导。

• 首席观点列表检索

按关键词、证券、券商、研究方向、首席分析师、概念、投研标签、来源类型等条件检索首席观点列表。

示例（关键词 + 标签 + 来源）：

python3 scripts/opinion.py -k 半导体 --llm_tags strongRcmd --source_types realTime -l 20

券商枚举值可通过 scripts/获取_institutions.py 获取。研究方向名称（宏观、策略、固收、金工、海外等）见 scripts/utils.py 中 RE搜索_AREA_MAP。详见 首席观点调用指导。

• 投研日程（路演 / 调研 / 线下策略会 / 论坛）

示例（路演 + 关键词 + 时间）：

python3 scripts/investment_calendar.py -t roadshow -k 策略会 -sd 2026-02-01 -ed 2026-03-30 -l 20

机构枚举见 scripts/获取_institutions.py；研究方向中文名见 scripts/utils.py 中 RE搜索_AREA_MAP。详见 投研日程调用指导。

• 获取枚举值

获取行业、机构的枚举值列表，用于为上述检索脚本提供参数可选值。

python3 scripts/获取_industries.py python3 scripts/获取_institutions.py python3 scripts/获取_regions.py

• 下载文件

根据文件 ID 与文件类型下载完整文件至本地。

示例（下载文件）：

python3 scripts/获取_file.py --file-id 1234567890 --file-type "研究报告"