Agent skill

Sn Search Year Report

by OpenSenseNova in OpenSenseNova/SenseNova-Skills

用于搜索免费官方年报、年度报告、定期报告、上市公司披露文件、债券发行人报告和海外公司年度账目. An agent skill from OpenSenseNova/SenseNova-Skills.

MITAuto-check: notesDocuments & Office

Install Sn Search Year Report

skills CLI
$ npx skills add OpenSenseNova/SenseNova-Skills --skill sn-search-year-report -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install OpenSenseNova/SenseNova-Skills sn-search-year-report --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/OpenSenseNova/SenseNova-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sn-search-year-report .claude/skills/sn-search-year-report && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sn-search-year-report
GitHub stars
5.7k
Token cost
~818 tokens
SKILL.md length
204 words
Files
2 (incl. scripts)
Skills in repo
36
Repo updated
First seen
Licence
MIT

At a glance

用于搜索免费官方年报、年度报告、定期报告、上市公司披露文件、债券发行人报告和海外公司年度账目. An agent skill from OpenSenseNova/SenseNova-Skills.

  • Works in 5 steps: 先判断主体类型:A… → scripts/year_report_api.py 和 browser-use… → 没有脚本覆盖或需要交互筛选的来源,用 browser-use… → …
  • Documents & Office work in your project
  • SKILL.md covers 凭证配置, 工作流, API 脚本 and Browser-use 资源, plus 2 more sections
  • Runs Python scripts from its folder; calls python; reaches gsxt.gov.cn and static.cninfo.com.cn

What it does

Sn Search Year Report is an agent skill from OpenSenseNova/SenseNova-Skills. 用于搜索免费官方年报、年度报告、定期报告、上市公司披露文件、债券发行人报告和海外公司年度账目。

Its SKILL.md is about 820 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/year_report_api.py`).

It sits in Documents & Office. The repository describes itself as: Modular SenseNova skills for building AI-powered office assistants and productivity workflows. The licence is MIT.

When your agent uses it

  • Documents & Office work in your project

Example prompts

  • “/sn-search-year-report”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. 先判断主体类型:A 股/港股/美股/英企/日本上市公司/发债主体/加拿大/新加坡/澳洲。
  2. scripts/year_report_api.py 和 browser-use 可混合使用:脚本适合结构化查询,网页适合站内筛选、页面确认、下载公开 PDF。
  3. 没有脚本覆盖或需要交互筛选的来源,用 browser-use 打开下表网页,通过站内搜索、筛选公告类别、定位 PDF 或详情页。
  4. 只接受官方披露源;公司官网 IR 可作补充,但不能替代官方源。
  5. 中国普通非上市企业通常没有公开完整财务年报;工商年报不是审计财报,且本技能已丢弃不可稳定访问的工商公示系统。

What it can do on your machine

Read from SKILL.md and the folder at commit 7838651. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • gsxt.gov.cn
    • static.cninfo.com.cn

    Also links to:

    • cninfo.com.cn
    • sse.com.cn
    • szse.cn
    • bse.cn
    • www1.hkexnews.hk
    • shclearing.com.cn
    • bond.sse.com.cn
    • find-and-update.company-information.service.gov.uk
    • sedarplus.ca
    • sgx.com
    • asx.com.au

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sn Search Year Report loads about 818 tokens when it runs. Until then it costs about 17 tokens; SKILL.md has 204 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~17
When it runs · the whole SKILL.md, loaded when a task matches
~818

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:10
    API key、token 与 cookie 统一建议写在仓库根目录 `.env`(参考 `.env.example`),并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证;不要把真实密钥

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from OpenSenseNova/SenseNova-Skills at commit 7838651, republished under its MIT licence (© OpenSenseNova). 204 words, ~818 tokens.

Download SKILL.mdSave it as .claude/skills/sn-search-year-report/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
sn-search-year-report
description
用于搜索免费官方年报、年度报告、定期报告、上市公司披露文件、债券发行人报告和海外公司年度账目。

Search Year Report

凭证配置

API key、token 与 cookie 统一建议写在仓库根目录 .env(参考 .env.example),并由 runtime 或用户在执行前加载为同名环境变量。脚本仍只从环境变量或显式 CLI 参数读取凭证;不要把真实密钥写入 skill payload、报告、日志或提交。

只使用免费、官方、可正常访问的年报/年度账目/定期报告来源。遇到商业库、订阅、试用额度、付费下载、登录墙、验证码、防护页、不可访问页面,立即丢弃,不要绕过限制。

输出时保留公司/证券代码、报告期、文件标题、披露日期、PDF 或详情页 URL、来源名称。

工作流

  1. 先判断主体类型:A 股/港股/美股/英企/日本上市公司/发债主体/加拿大/新加坡/澳洲。
  2. scripts/year_report_api.py 和 browser-use 可混合使用:脚本适合结构化查询,网页适合站内筛选、页面确认、下载公开 PDF。
  3. 没有脚本覆盖或需要交互筛选的来源,用 browser-use 打开下表网页,通过站内搜索、筛选公告类别、定位 PDF 或详情页。
  4. 只接受官方披露源;公司官网 IR 可作补充,但不能替代官方源。
  5. 中国普通非上市企业通常没有公开完整财务年报;工商年报不是审计财报,且本技能已丢弃不可稳定访问的工商公示系统。

API 脚本

脚本位置:scripts/year_report_api.py。只依赖 Python 标准库。

bash
python scripts/year_report_api.py cninfo "平安银行" --year 2023 --page-size 5
python scripts/year_report_api.py sec-company apple --limit 5
python scripts/year_report_api.py sec-filings --ticker AAPL --limit 5
python scripts/year_report_api.py download "https://static.cninfo.com.cn/finalpage/2024-03-15/1219306493.PDF" --output report.pdf
命令免费性用途
cninfo免费、免 key巨潮资讯 A 股公告,默认查年度报告 PDF
sec-company / sec-filings免费、免 keySEC EDGAR 公司 CIK、10-K/20-F/40-F 年报文件
download免费公开 URL下载脚本返回的公开 PDF

cninfo --year 表示报告期年份;脚本会自动查下一年的披露窗口。若要按披露日期精确过滤,改用 --date-range。

脚本只保留免 key 接口;任何需要 API key、token、注册登录或订阅的接口都不要加入脚本。

Browser-use 资源

以下来源作为免费官方网页入口;按任务需要与 API 脚本混合使用。

范围资源URL使用要点
A 股全市场巨潮资讯https://www.cninfo.com.cn/new/index?lang=zh搜索公司名/证券代码,筛“年度报告”
沪市上市公司上交所定期报告https://www.sse.com.cn/disclosure/listedinfo/regular/按证券代码、年份、定期报告筛选
深市上市公司深交所上市公司公告https://www.szse.cn/www/disclosure/notice/company/按公司、公告类型、时间筛选
北交所上市公司北交所信息披露https://www.bse.cn/disclosure/announcement.html搜索年度报告/定期报告
港股HKEXnews Predefined Documentshttps://www1.hkexnews.hk/search/predefineddoc.xhtml选 Annual Report / Environmental, Social and Governance Information
中国债券发行人中国货币网债券信息披露https://www.chinamoney.org.cn/chinese/zqfx/搜索发行人年报、审计报告、跟踪评级
中国债券发行人上海清算所https://www.shclearing.com.cn/搜索发行人年度报告/审计报告
中国债券发行人上交所债券信息披露https://bond.sse.com.cn/disclosure/搜索债券发行人年度报告
英国公司账目Companies House 网页https://find-and-update.company-information.service.gov.uk/无 API key 时查 filing history / accounts
加拿大上市公司SEDAR+ Documents Searchhttps://www.sedarplus.ca/csa-party/service/create.html?_locale=en&service=searchDocuments&targetAppCode=csa-party选择 Documents,按 issuer/profile 和 annual filings 搜索
新加坡上市公司SGX Company Announcementshttps://www.sgx.com/securities/company-announcements搜索 Annual Report 或公司代码
澳洲上市公司ASX Announcementshttps://www.asx.com.au/markets/trade-our-cash-market/announcements按 ASX code 和 announcement type 搜索

已丢弃

资源原因
国家企业信用信息公示系统 https://www.gsxt.gov.cn/与工商年报相关,但访问被阻断,不作为稳定免费源
市场监管总局说明页只是政策说明,不是年报搜索入口
Companies House API、EDINET API需要 API key,不写入脚本
任何商业数据库或付费 API不符合免费官方源要求

输出规范

能定位到 PDF 时给 PDF;没有 PDF 时给官方详情页。说明报告类型差异:工商年报、上市公司年度报告、SEC 10-K/20-F/40-F、Companies House accounts、债券发行人年度报告不是同一披露口径。

© OpenSenseNova, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in skills/sn-search-year-report of OpenSenseNova/SenseNova-Skills.

  • SKILL.md
  • scripts/year_report_api.py

Open the folder on GitHubat commit 7838651

Compare with similar skills

Sn Search Year Report next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sn Search Year Report compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sn Search Year Report this skillOpenSenseNova/SenseNova-Skills5.7k—~818Automated safety check: NotesMIT
Markdown Article FormatterJimLiu/baoyu-skills27k6 repos~3.5kAutomated safety check: PassMIT
MarkitdownImCa0/just-laws78114 repos~3.2kAutomated safety check: NotesMIT
Obsidian MarkdownAtmosphere/atmosphere3.8k20 repos~1.3kAutomated safety check: PassApache-2.0
DOCXrvdbreemen/OTGW-firmware20733 repos~4.3kAutomated safety check: PassProprietary
Word Document Reader and WriterHKUDS/DeepTutor41k—~2.5kAutomated safety check: PassApache-2.0

Similar skills

  • Markdown Article Formatter

    JimLiu/baoyu-skills

    Reformats plain text or Markdown articles with frontmatter, a title, a summary, headings, bold, lists and code blocks, and saves a separate formatted copy.

    27k GitHub starsUsed in 6 repos~3.5k tokens
    Documents & OfficeAuto-check passed
  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    781 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Obsidian Markdown

    Atmosphere/atmosphere

    Create and edit Obsidian Flavored Markdown with wikilinks, embeds, callouts, properties, and other Obsidian-specific syntax.

    3.8k GitHub starsUsed in 20 repos~1.3k tokens
    Documents & OfficeAuto-check passed
  • DOCX

    rvdbreemen/OTGW-firmware

    A skill your agent uses whenever the user wants to create, read, edit, or manipulate Word documents (.docx files).

    207 GitHub starsUsed in 33 repos~4.3k tokens
    Documents & OfficeAuto-check passed
  • Reads, creates and edits Word .docx files with python-docx, and drops to raw OOXML for tracked changes, comments and byte-exact edits.

    41k GitHub stars~2.5k tokensUpdated 3 days ago
    Documents & OfficeAuto-check passed
  • Crossposting

    wasp-lang/wasp

    Crosspost Wasp blog articles (MDX) to DEV.to and Medium. An agent skill from wasp-lang/wasp.

    19k GitHub stars~1.1k tokensUpdated today
    Documents & OfficeAuto-check passed

More from OpenSenseNova/SenseNova-Skills

All 36 skills in this repo
  • SN Motion HTML

    OpenSenseNova/SenseNova-Skills

    Builds HTML stories where one continuous camera journey advances with page progress, using researched structure, AI stills, Seedance video clips and browser QA.

    5.7k GitHub stars~2.2k tokensUpdated 2 days ago
    Auto-check: notes
  • SenseNova PPT Fallback Tools

    OpenSenseNova/SenseNova-Skills

    Fallback scripts for web search, image search and download, and image generation that PPT skills use only when the host agent lacks or fails its own tools.

    5.7k GitHub stars~575 tokensUpdated 2 days ago
    Auto-check: notes
  • SenseNova PPT Workbench

    OpenSenseNova/SenseNova-Skills

    Opens the PPT Workbench web editor for an existing SenseNova HTML slide deck so you can preview, inspect and visually edit it without regenerating.

    5.7k GitHub stars~2.5k tokensUpdated 2 days ago
    Auto-check: notes
  • SenseNova PPT Creative Renderer

    OpenSenseNova/SenseNova-Skills

    Turns an approved slide outline into a full-page image for every slide, one 16:9 PNG per page, and optionally packages the set into a PPTX.

    5.7k GitHub stars~1.2k tokensUpdated 2 days ago
    Auto-check passed
  • SenseNova PPT Entry

    OpenSenseNova/SenseNova-Skills

    Entry point for SenseNova presentation generation: creates a task folder, picks depth, output format and design richness, and routes to the right PPT skill.

    5.7k GitHub stars~2.7k tokensUpdated 2 days ago
    Auto-check: notes
  • China Market Open Data Search

    OpenSenseNova/SenseNova-Skills

    Researches Chinese market, macro, trade, procurement, listed-company and regulatory information from free official sources that need no sign-up or API key.

    5.7k GitHub stars~954 tokensUpdated 2 days ago
    Auto-check: notes

Questions about Sn Search Year Report

What does Sn Search Year Report do?

用于搜索免费官方年报、年度报告、定期报告、上市公司披露文件、债券发行人报告和海外公司年度账目. An agent skill from OpenSenseNova/SenseNova-Skills. Sn Search Year Report is an agent skill from OpenSenseNova/SenseNova-Skills.

When should I use Sn Search Year Report?

Sn Search Year Report fits situations like: documents & Office work in your project.

How do I install Sn Search Year Report in Claude Code?

Run `npx skills add OpenSenseNova/SenseNova-Skills --skill sn-search-year-report -a claude-code`. Or copy the skill folder (skills/sn-search-year-report in OpenSenseNova/SenseNova-Skills) into .claude/skills/sn-search-year-report in your project. Claude Code loads it when a task matches its description.

How do I install Sn Search Year Report in Codex?

Run `npx skills add OpenSenseNova/SenseNova-Skills --skill sn-search-year-report -a codex`. Or copy the skill folder (skills/sn-search-year-report in OpenSenseNova/SenseNova-Skills) into .agents/skills/sn-search-year-report in your project. Codex loads it when a task matches its description.

Can I use Sn Search Year Report in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add OpenSenseNova/SenseNova-Skills --skill sn-search-year-report -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sn-search-year-report, .gemini/skills/sn-search-year-report, .github/skills/sn-search-year-report and .opencode/skills/sn-search-year-report in your project.

What does Sn Search Year Report need to run?

Going by SKILL.md and its folder, Sn Search Year Report needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Sn Search Year Report access the network?

SKILL.md names 13 domains. In commands or code: gsxt.gov.cn and static.cninfo.com.cn; the agent is likely to contact these when it follows the instructions. As links in the text: cninfo.com.cn, sse.com.cn, szse.cn, bse.cn, www1.hkexnews.hk, shclearing.com.cn, bond.sse.com.cn, find-and-update.company-information.service.gov.uk, sedarplus.ca, sgx.com and asx.com.au. This is read from the text; nothing was executed.

Is Sn Search Year Report safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Sn Search Year Report use?

Sn Search Year Report is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sn Search Year Report use?

About 818 tokens (SKILL.md is roughly 3.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sn Search Year Report?

Skills that share tags, products or a category with Sn Search Year Report: Markdown Article Formatter (JimLiu/baoyu-skills, 27k stars), Markitdown (ImCa0/just-laws, 781 stars), Obsidian Markdown (Atmosphere/atmosphere, 3.8k stars) and DOCX (rvdbreemen/OTGW-firmware, 207 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sn Search Year Report?

OpenSenseNova (a GitHub organization) maintains it in OpenSenseNova/SenseNova-Skills, which has 5,749 GitHub stars. The repository holds 36 skills in this directory. The repository was last updated on October 9, 2026.

Source: OpenSenseNova/SenseNova-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.