技能使用指南

announcement-search（公告搜索）Skill 是什么？如何下载安装使用？

公告搜索Skill（announcement-search）可一句话查询A股、港股、基金、ETF公告，覆盖财报、分红派息、回购增持、资产重组等类型，支持自然语言、CLI与API调用。本文详解API Key配置安装步骤、核心功能、竞品对比、典型场景与常见问题，帮你快速把公告检索接入AI工作流。

公告搜索Skillannouncement-search
12 个章节 约 15 分钟阅读 AI 智能生成

公告搜索Skill：一句话查清A股、港股、基金与ETF公告，财报分红回购信息快速到手

  • 它是什么：公告搜索Skill（英文名 announcement-search，技能ID 14222）是一个金融公告搜索引擎，通过调用同花顺问财的公告搜索接口，帮助用户查询 A股、港股、基金、ETF 等金融标的的最新公告。
  • 能查什么：定期财务报告、分红派息、回购增持、资产重组、重大合同、业绩预告等公告类型均可覆盖，支持中文关键词搜索。
  • 怎么用：在支持 AI 技能的环境里用自然语言直接提问（例如“搜索贵州茅台最近一个月的公告”），也可以走 CLI 命令行或直接调用 OpenAPI 接口，三种方式共用同一套能力。
  • 前置条件只有一个：需要先在同花顺 i问财 SkillHub 获取 IWENCAI_API_KEY 并配置为环境变量，配置一次即可长期使用。
  • 适合谁：需要跟踪持仓公告的投资者、做公告事件研究的投研人员、盯盘与信披监控的财经内容从业者，以及把公告数据接入自有工作流的开发者。

该技能叫什么？如何下载安装 AI 技能提升开发效率？

技能中文名：公告搜索Skill 技能英文名：announcement-search 技能ID：14222

它解决的是一个非常具体、但日常又极其耗时的痛点：金融公告分散、格式冗长、检索成本高。上市公司公告动辄几十页 PDF，同一家公司一天可能发好几条，投资者想快速知道“最近有没有分红”“业绩预告说了什么”“有没有回购计划”，往往要在交易所网站、财经门户、搜索引擎之间来回跳转。公告搜索Skill 把这层检索工作封装成一个可被 AI 直接调用的能力，让“查公告”变成一句话的事。

安装与配置的关键思路：把 Key 配好，技能就跑起来了

这个技能本身不需要下载庞大的客户端，它的核心是一次性的 API Key 配置——配好之后，AI 助手就能随时调用公告搜索能力，这就是“一键安装、长期复用”的效率提升逻辑。

安装前提：所有技能都需要 IWENCAI_API_KEY 环境变量才能使用。如果尚未配置，按下面四步走：

步骤 1：获取 API Key 在浏览器中打开同花顺 i问财 SkillHub 页面：https://www.iwencai.com/skillhub

步骤 2：登录 使用你的账号登录该平台。

步骤 3：查看并复制 Key 点击具体的 Skill，打开弹窗查看详情，在「安装方式 - Agent用户」区域找到「您的 IWENCAI_API_KEY」这一段，复制其中的 Key。

步骤 4：配置环境变量 获取到 API Key 后，可以直接把指引文字复制发送给 AI 助手让它帮你配置，也可以手动设置环境变量：

macOS / Linux（bash/zsh）：

export IWENCAI_API_KEY="your_api_key_here"

Windows（PowerShell）：

$env:IWENCAI_API_KEY="your_api_key_here"

Windows（CMD）：

set IWENCAI_API_KEY=your_api_key_here

验证是否生效：配置完成后，直接对 AI 助手说一句“搜索贵州茅台最近一个月的公告”，或执行 announcement-search "贵州茅台 公告"。如果能返回带标题、摘要、链接和发布时间的结构化结果，说明配置成功；若提示鉴权失败，多半是环境变量未生效（可重开终端）或 Key 复制不完整。

提示：技能支持通过配置文件管理 API Key 等敏感信息，配置文件示例见 scripts/config.example.json。关于平台版本、配额与收费政策，以官方说明为准。

该技能的主要功能和特点

  • 多市场、多品种覆盖：支持 A股、港股、基金、ETF 等金融标的的公告查询，不局限于单一交易所或单一品种。
  • 公告类型足够全：定期财务报告、分红派息、回购增持、资产重组之外，还覆盖重大合同、业绩预告等类型，且公告类型“包括但不限于”这些常见类别。
  • 智能查询拆解：自动分析用户查询意图，遇到复合问题会判断是否拆成多个简单查询。例如“最近贵州茅台和五粮液有什么公告？”可拆为“贵州茅台 公告”和“五粮液 公告”两次查询，并按查询复杂度决定接口调用次数。
  • 结果质量评估与扩展：会评估搜索结果能否回答用户问题，必要时调用其他技能或工具扩展数据，并对结果做相关性与质量排序。
  • 结构化输出：对结果排序、过滤、摘要，返回包含标题、摘要、网址、发布时间的结构化数据，方便大模型直接组织答案。
  • CLI 命令行友好：提供基本搜索、批量搜索、数据导出等命令行能力，支持指定输出格式，便于嵌入脚本与自动化流程。
  • 工程规范到位：请求需携带完整的 Claw 请求头（含每次新生成的 64 字符 Trace ID），API Key 从环境变量读取、禁止硬编码，具备完善的错误处理机制。

和普通搜索工具比强在哪：普通搜索返回的是“网页链接列表”，需要你自己点开、翻页、判断哪条是公告原文；公告搜索Skill 直接命中公告频道（请求中固定 channels: ["announcement"]），返回的是公告标题、摘要与发布时间，并做了相关性排序，等于把“检索 + 筛选 + 摘要”三步压缩成一步。

如何使用该技能？

方式一：自然语言调用（最省事）

  1. 确认 IWENCAI_API_KEY 已配置。
  2. 在 AI 助手中直接提问，例如：
    • “搜索贵州茅台最近一个月的公告”
    • “查询宁德时代的业绩预告”
    • “查看中国平安的分红公告”
    • “搜索最近有哪些公司发布了回购计划”
    • “查询创业板公司的年报公告”
  3. 技能自动解析意图 → 必要时拆解为多个查询 → 调用接口 → 排序过滤 → 返回结构化结果。
  4. 阅读回答时注意：引用同花顺数据的内容会标注数据来源于同花顺问财。

方式二：CLI 命令行调用

# 基本搜索
announcement-search "上市公司业绩预告"

# 批量搜索（从文件读取查询）
announcement-search --input queries.txt --output results.csv

# 指定输出格式
announcement-search "分红派息" --format json

输入示例：announcement-search "贵州茅台 公告" 输出说明：返回结构化公告列表，每条包含 title（标题）、summary（摘要）、url（原文网址）、publish_date（发布时间，格式 YYYY-MM-DD HH:MM:SS）。

方式三：直接调用 OpenAPI 接口（适合开发者集成）

  • Base URL：https://openapi.iwencai.com
  • 接口路径：/v1/comprehensive/search
  • 请求方式：POST（优先使用 POST）
  • 认证方式：API Key（Bearer Token），从环境变量 IWENCAI_API_KEY 读取
  • 固定参数：channels: ["announcement"]、app_id: "AIME_SKILL"
  • 可变参数：query（用户问句）

curl 示例（脱敏）：

curl -X POST "https://openapi.iwencai.com/v1/comprehensive/search" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $IWENCAI_API_KEY" \
  -H "X-Claw-Call-Type: normal" \
  -H "X-Claw-Skill-Id: announcement-search" \
  -H "X-Claw-Skill-Version: 1.0.0" \
  -H "X-Claw-Plugin-Id: none" \
  -H "X-Claw-Plugin-Version: none" \
  -H "X-Claw-Trace-Id: $(python3 -c 'import secrets; print(secrets.token_hex(32))' 2>/dev/null || openssl rand -hex 32)" \
  -d '{
    "channels": ["announcement"],
    "app_id": "AIME_SKILL",
    "query": "贵州茅台 公告"
  }'

注意三个细节：Trace ID 必须是每次请求新生成的 64 字符十六进制字符串；API Key 必须从环境变量读取，禁止硬编码；所有 Claw 请求头必须正确设置，X-Claw-Skill-Version 与技能版本保持一致（当前 1.0.0）。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
公告搜索Skill（announcement-search） 面向 AI 助手的金融公告搜索能力 A股/港股/基金/ETF 公告检索，覆盖财报、分红、回购、重组等；智能拆解查询、结果排序摘要、CLI 与 API 双通道 需获取并配置 IWENCAI_API_KEY，配置一次即可；自然语言即可调用 让 AI 直接回答“某公司最近有什么公告”，接入自动化脚本 优势：与 AI 工作流天然融合、结果结构化、支持批量与导出；不足：依赖 Key 与外网接口，超高频调用需注意 API 限制
交易所/指定信披平台网站 官方公告原文披露渠道 提供公告原文 PDF 与检索 零门槛，浏览器直接访问 需要阅读公告原文、核对法定披露细节 优势：权威、原文完整；不足：需人工逐条筛选，多市场需跨站，难以批量与结构化处理
金融数据终端 专业投研数据平台 公告、行情、财务、研报等一体化数据 需付费订阅并安装专业客户端，学习成本较高 机构投研、深度财务分析 优势：数据维度全、专业指标丰富；不足：成本高、上手重，轻量查询场景性价比低
通用搜索引擎 / 大模型联网搜索 泛信息检索 关键词检索全网页内容 零门槛 泛化资讯了解 优势：覆盖面广、免费；不足：公告内容易被资讯稿稀释，时效与准确性依赖来源，缺乏公告频道定向能力

怎么选：追求“AI 直接给答案 + 可集成”选公告搜索Skill；要核对法定原文选交易所/指定信披平台；做深度投研选专业终端；只是泛泛了解可选通用搜索。各平台具体功能与价格以官方说明为准。

该技能的典型应用场景与实际体验情况

场景一：个人投资者追踪持仓公告 痛点：手上十几只股票，每天手动翻网站看有没有新公告，容易漏掉分红、回购这类关键信息。使用方式：直接问“搜索最近有哪些公司发布了回购计划”，或按持仓逐个查询“XX 分红公告”。体验：自然语言即可上手，无需学习检索语法；返回的摘要能在几秒内判断“这条和我有没有关系”。注意：公告时效性取决于数据源更新节奏，重要决策仍应点开原文链接核对。

场景二：投研人员做事件驱动研究 痛点：研究资产重组、业绩预告类事件时，需要横向拉取多家公司的公告做对比。使用方式：用批量搜索从文件读取一批查询，输出 CSV 汇总成表格。体验：批量 + 导出是效率提升最明显的环节，把“一个个复制粘贴”变成了“一次跑完”。注意：批量任务应控制并发与频率，遵守接口使用限制。

场景三：财经内容创作者做选题监控 痛点：需要及时发现“哪家公司发了重大合同/业绩预告”这类可写素材。使用方式：定期执行 announcement-search "上市公司业绩预告" 观察最新结果。体验：结构化返回的标题 + 发布时间，天然适合做成选题清单。注意：引用数据时须标注来源于同花顺问财。

场景四：开发者把公告能力嵌入自有系统 痛点：自建投研工具时，公告数据采集与清洗成本高。使用方式：直接 POST 调用 /v1/comprehensive/search，固定 channels: ["announcement"]，按需传 query。体验：接口清晰，请求头规范明确，data 字段结构简单易解析。注意：务必妥善保管 API Key，不要写进客户端代码，Trace ID 每次重新生成。

整体上手难度：低。唯一门槛是 API Key 配置；功能边界清晰，不容易误用。

该技能能为用户带来的价值

  • 把“查公告”从分钟级压缩到秒级：过去需要打开网站、输入关键词、翻多页、点开 PDF 判断相关性；现在一句话拿到标题 + 摘要 + 时间 + 链接，检索环节几乎零成本。
  • 降低专业数据的使用门槛：不需要订阅专业终端、不需要懂检索语法，中文自然语言提问即可覆盖 A股、港股、基金、ETF 多类标的。
  • 减少遗漏风险：回购、分红、业绩预告这类信息一旦漏看可能直接影响决策，技能按公告频道定向检索，比泛搜索更容易命中真正的公告。
  • 可集成带来的长期复利：CLI 与 OpenAPI 双通道意味着它能被嵌进日报脚本、监控任务、内部投研系统，一次接入、长期复用，边际成本接近于零。
  • 结果可追溯：每条结果都带原文网址与发布时间，便于核对与留痕，适合需要引用出处的严肃场景。

常见问题 FAQ

Q1：这个技能怎么安装？需要下载客户端吗？ 不需要安装重型客户端。核心是配置 IWENCAI_API_KEY 环境变量：登录同花顺 i问财 SkillHub，点开对应 Skill 弹窗，在「安装方式 - Agent用户」中找到并复制 Key，然后按 macOS/Linux 或 Windows 对应命令设置环境变量即可。具体安装方式与版本以官方说明为准。

Q2：收费吗？有调用次数限制吗？ 技能详情中未说明具体定价与配额。请以同花顺 i问财 SkillHub 的官方说明为准。技能本身提示“请遵守 API 使用限制，避免频繁请求”，批量任务建议合理控制频率。

Q3：支持查港股和基金公告吗？能查哪些公告类型？ 支持。可查询 A股、港股、基金、ETF 等金融标的公告，公告类型包括但不限于定期财务报告、分红派息、回购增持、资产重组、重大合同、业绩预告等，且支持中文关键词搜索。

Q4：查到的公告准确吗？可以直接作为投资依据吗？ 公告信息来源于同花顺问财，技能会做排序、过滤和摘要处理。但摘要不等于原文，且需注意数据时效性；涉及关键决策时，建议通过返回的 url 打开公告原文核对。引用同花顺数据时须强调数据来源于同花顺问财。

Q5：它和专业金融终端、交易所官网比，应该怎么选？ 需要 AI 直接给答案、批量处理或嵌入自动化流程，选公告搜索Skill；需要阅读法定披露原文、逐字核对条款，去交易所或指定信披平台；需要行情 + 财务 + 研报一体化深度分析，再考虑专业数据终端。三者更多是互补关系，而非完全替代。