← Back to Skills Marketplace
wenzisay

iFinD投研-公司公告信息搜索

by wenzi · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
158
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install ifind-repilot-announcement-search
Description
通过问句语义化搜索A股、基金、港美股相关公告信息(年报、半年报、季报、临时公告、招股说明书等),返回与问句相关的公告片段信息。当需要检索上市公司公告、财务报告、监管公告等信息时,使用此 skill。
README (SKILL.md)

概述

此 skill 通过自然语言问句查询(向量检索)全市场公司公告信息。它调用封装好的 Python 脚本,向同花顺数据接口发送请求,返回与问句相关的公告列表信息。支持按照时间范围查询。

前置要求

环境依赖

  • Python 3.x
  • 标准库:json, urllib, pathlib
  • 无需安装第三方库
  • 注1:若 python3 命令不可用(常见于 Windows),请改用 python
  • 注2:\x3Cskill_dir> 为当前 skill 所在目录的完整路径,请根据当前上下文自动获取。

首次配置

首次使用 skill 前,需要先配置认证 token。

  1. 提示用户先从飞研平台获取 token。平台地址: https://repilot.51ifind.com/ ,菜单路径:业务管理 -> Skills技能库。
  2. 用户提供token后,运行以下命令配置 token:
python3 \x3Cskill_dir>/scripts/fetch_data.py --set-token \x3Cyour_auth_token>
  1. 检查 token 是否已配置:
python3 \x3Cskill_dir>/scripts/fetch_data.py --check-token

注:配置文件位于:~/.config/ifind-repilot/config.json

使用方式

基本查询

python3 \x3Cskill_dir>/scripts/fetch_data.py "\x3C查询语句>"

带时间范围查询

python3 \x3Cskill_dir>/scripts/fetch_data.py "\x3C查询语句>" --start-date \x3C开始日期> --end-date \x3C结束日期>

日期格式:YYYY-MM-DDTHH:MM:SS,例如 2025-01-01T00:00:00

日期参数可以放在查询语句之前或之后:

# 方式一:日期参数在前
python3 \x3Cskill_dir>/scripts/fetch_data.py --start-date 2025-01-01T00:00:00 --end-date 2026-01-01T00:00:00 "同花顺公告"

# 方式二:日期参数在后
python3 \x3Cskill_dir>/scripts/fetch_data.py "同花顺公告" --start-date 2025-01-01T00:00:00 --end-date 2026-01-01T00:00:00

查询示例

查询内容 命令
同花顺公告 python3 \x3Cskill_dir>/scripts/fetch_data.py "同花顺公告"
贵州茅台临时公告 python3 \x3Cskill_dir>/scripts/fetch_data.py "贵州茅台临时公告"
2025年同花顺公告 python3 \x3Cskill_dir>/scripts/fetch_data.py "同花顺公告" --start-date 2025-01-01T00:00:00 --end-date 2025-12-31T23:59:59

返回格式

脚本直接返回查询结果的 JSON 数据,包含以下字段:

字段 类型 说明
total int 检索到的公告总数
status_code int 状态码,0表示成功
status_msg string 状态信息
data array 公告列表

每条公告包含以下字段:

字段 类型 说明
title string 公告标题
summary string 公告摘要
url string 公告原文链接
channel string 频道类型
publish_time int 发布时间(Unix时间戳)
publish_date string 发布时间(格式:YYYY-MM-DD HH:MM:SS)
score float 相关性评分
stock_infos array 关联股票信息列表,每项包含 codename
extra object 扩展信息

返回示例:

{
  "total": 4,
  "status_code": 0,
  "data": [
    {
      "title": "同花顺:关于股票交易异常波动公告",
      "summary": "证券代码:300033         证券简称:同花顺         公告编号:2024-029\
浙江核新同花顺网络信息股份有限公司关于股票交易异常波动公告...",
      "url": "http://static.cninfo.com.cn/finalpage/2024-09-30/1221332134.PDF",
      "channel": "announcement",
      "publish_time": 1727625600,
      "publish_date": "2024-09-30 00:00:00",
      "score": 0.108995356,
      "stock_infos": [
        {"code": "A00627"},
        {"code": "300033", "name": "同花顺"}
      ],
      "extra": {}
    }
  ],
  "status_msg": "OK"
}

错误处理

错误信息 原因 解决方法
请先配置 auth_token 未设置 token 提示用户获取并发送token,收到token后,运行 --set-token 配置
API HTTP 错误 请求失败 检查网络或 API 地址
网络错误 无法连接 检查网络连接
API 返回失败 接口返回错误 查看具体错误信息
API HTTP 错误: 429 触发当日请求限制 提醒用户到飞研平台检查用量信息
API HTTP 错误: 401 缺失token或者token无效 提醒用户检查token是否正确
API HTTP 错误: 403 没有权限访问接口 没有权限访问接口

执行规则

  1. 先判断用户请求或任务是否需要公司公告检索。
  2. 若需要公司公告检索,根据用户请求内容与思考,生成一个合适的自然语言查询语句作为参数调用脚本。
  3. 若请求返回未检索到数据、或者返回的数据不符合期望,可以尝试生成一个新的自然语言查询语句重新查询。
  4. 不要编造任何公告信息。若脚本失败或返回空结果,应明确说明失败原因或未检索到数据。
  5. 将脚本输出中的信息重新组织和提炼;保留公告标题、关联股票和摘要中的重要数据。
  6. 当出现401、403、429错误时,请勿再重试,直接提醒用户skill返回的错误内容。
Usage Guidance
This skill appears to do what it claims: it runs a bundled Python script that queries iFinD/Repilot announcement APIs. Before installing or using it: 1) Only supply a token you obtained from the stated repilot/ifind platform and avoid reusing high-privilege or cross-service tokens. 2) Verify the base_url in ~/.config/ifind-repilot/config.json remains the expected repilot.51ifind.com; do not run --set-url unless you trust the target. 3) Be aware the token is stored in plaintext JSON under your home directory—if you need stronger protection, restrict file permissions or use a different secret storage. 4) Review the script yourself if you have doubts; it performs network calls and will send the stored auth token in the Authorization header. 5) Do not run the script with elevated privileges; run it under your normal user account.
Capability Analysis
Type: OpenClaw Skill Name: ifind-repilot-announcement-search Version: 1.0.2 The skill is a legitimate tool for searching financial announcements using the iFind Repilot API. The Python script `scripts/fetch_data.py` manages an authentication token stored in a local configuration file (`~/.config/ifind-repilot/config.json`) and performs standard HTTPS GET requests to the official domain `https://repilot.51ifind.com/`. No evidence of data exfiltration, malicious execution, or prompt injection was found.
Capability Assessment
Purpose & Capability
The skill name/description describe semantic search of company announcements and the included Python script implements that: it constructs a query, sends it to a repilot.51ifind.com open API endpoint, and returns JSON results. Required binary is only python3 and no unrelated credentials or binaries are requested.
Instruction Scope
SKILL.md instructs the agent to call the bundled script and to configure an auth token obtained from the repilot platform; this aligns with the purpose. Note: the script supports a --set-url option that lets the stored base_url be changed from the default (repilot.51ifind.com) — if misused this could redirect requests (and the auth token) to another endpoint. The instructions themselves do not require reading unrelated files or environment variables.
Install Mechanism
No install spec; the skill is instruction-only with one Python script. Nothing is downloaded or written by an installer. Execution risk is limited to running the provided script.
Credentials
No environment variables or external credentials are declared, but the script requires an auth_token stored in ~/.config/ifind-repilot/config.json. Requiring a single service token is proportionate to the stated API usage. Minor concerns: the token is stored in plaintext under the user's home directory and the script will send that token in an Authorization header to the configured base_url — ensure the token is not reused for other services and that the base_url is trusted.
Persistence & Privilege
always is false and the skill does not request system-wide changes. It writes only to its own config path under the user's home (~/.config/ifind-repilot/config.json), which is expected for storing the token. The skill does not modify other skills or global agent settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install ifind-repilot-announcement-search
  3. After installation, invoke the skill by name or use /ifind-repilot-announcement-search
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- No code or documentation changes detected in this version. - Functionality and user instructions remain the same as the previous release. - update py script
v1.0.1
Version 1.0.1 of ifind-repilot-announcement-search has no code or documentation changes. - No file changes detected in this release. - Functionality, usage, and documentation remain the same as the previous version. - update py script
v1.0.0
Initial release of ifind-repilot-announcement-search: - Enables semantic search for A-share, fund, and global stock announcements (annual, interim, quarterly, ad-hoc, prospectuses, etc.) via natural language queries. - Fetches and returns relevant announcement excerpts using a built-in Python script calling the official API. - Supports search by time range and provides clear output in JSON format, including titles, summaries, links, and relevance scores. - Requires initial token setup from the 飞研 platform for authentication. - Comprehensive error handling with specific user guidance for common issues (e.g., missing token, permission errors, rate limits). - Detailed usage instructions and sample commands included for quick adoption.
Metadata
Slug ifind-repilot-announcement-search
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is iFinD投研-公司公告信息搜索?

通过问句语义化搜索A股、基金、港美股相关公告信息(年报、半年报、季报、临时公告、招股说明书等),返回与问句相关的公告片段信息。当需要检索上市公司公告、财务报告、监管公告等信息时,使用此 skill。 It is an AI Agent Skill for Claude Code / OpenClaw, with 158 downloads so far.

How do I install iFinD投研-公司公告信息搜索?

Run "/install ifind-repilot-announcement-search" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is iFinD投研-公司公告信息搜索 free?

Yes, iFinD投研-公司公告信息搜索 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does iFinD投研-公司公告信息搜索 support?

iFinD投研-公司公告信息搜索 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created iFinD投研-公司公告信息搜索?

It is built and maintained by wenzi (@wenzisay); the current version is v1.0.2.

💬 Comments