sn-search-year-report SKILL.md skillA

sn-search-year-report from opensensenova/sensenova-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add opensensenova/sensenova-skills/sn-search-year-report@git:20260701.c44b261

Pins git:20260701.c44b261 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
opensensenova/sensenova-skills
Path
skills/sn-search-year-report/SKILL.md
Versions recorded
2
Latest version
git:20260701.c44b261, committed Jul 1, 2026
First version recorded
Jun 30, 2026
Size
5,311 bytes
Repository stars
6,031
License
MIT

用于搜索免费官方年报、年度报告、定期报告、上市公司披露文件、债券发行人报告和海外公司年度账目。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 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` | 免费、免 key | SEC EDGAR 公司 CIK、10-K/20-F/40-F 年报文件 |
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add opensensenova/sensenova-skills/sn-search-year-report@sha256:212f564e9142387f

The line at the top of this page pins the label git:20260701.c44b261, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_nzkcyahajoxs2wg7.svg)](https://markdownregistry.com/a/art_nzkcyahajoxs2wg7)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 2 versions of this file, between Jun 30, 2026 and Jul 1, 2026, more than one a day.

versioncommittedcommitsizeaudit
git:20260701.c44b261 latest2026-07-01 c44b261 5,311 BA view · diff
git:20260630.4afb99c2026-06-30 4afb99c 4,996 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (5311 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

opensensenova/sensenova-skills · 6,031 stars · license MIT · pushed 2026-11-03 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_nzkcyahajoxs2wg7
GET https://markdownregistry.com/api/v1/resolve?ref=opensensenova/sensenova-skills/sn-search-year-report
GET https://markdownregistry.com/api/v1/blob/212f564e9142387fb35ee32a5faab7e9d7d32c49487f0cbf78eadd55b212fce6

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from opensensenova/sensenova-skills

sn-code-video SKILL.md skill
opensensenova/sensenova-skills · skills/sn-code-video/SKILL.md · Create and revise code-driven videos with Canvas, SVG, HTML/CSS, Three.js, Remotion, Manim, or p5.js, including sound…
git:20261029.dae8ea5 · audit A · 6,031 stars
sn-da-excel-workflow SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/SKILL.md · Excel 数据分析多步编排器。覆盖:(1) 读取多 Sheet Excel 文件并统计行数,(2) 大文件检测(≥10k 行自动 Parquet 优化),(3) 数据清洗(缺失值、文本标准化、无效字符),(4)…
git:20260507.197eabb · audit A · 6,031 stars
large-file-parquet-analysis-and-highlight SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-cell-coloring/category-coloring/SKILL.md · 当Excel文件总行数超过1万行时,通过转换为Parquet格式提升读取性能,提取目标指标并计算最大值,最后将结果输出为Excel并对特定行进行高亮标注。
git:20260426.f0ab496 · audit A · 6,031 stars
excel-conditional-comparison-and-large-file-processing SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-cell-coloring/duplicate-value-coloring/SKILL.md · 对比Excel多表中的特定系数并对异常值进行颜色标记。
git:20260426.f0ab496 · audit A · 6,031 stars
excel-outlier-detection-and-highlighting SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-cell-coloring/outlier-coloring/SKILL.md · 识别 Excel 中的超限数值与错误单元格并进行高亮标注。
git:20260426.f0ab496 · audit A · 6,031 stars
large-file-conditional-formatting SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-cell-coloring/threshold-cell-coloring/SKILL.md · 根据Excel总行数自动切换Parquet加速读取,计算特定维度的时间序列平均值,并使用openpyxl输出带有条件格式(如低于均值标绿)和自定义样式的分析报告。
git:20260426.f0ab496 · audit A · 6,031 stars
top-value-coloring SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-cell-coloring/top-value-coloring/SKILL.md · 根据数据规模动态选择处理策略,对多表数据进行合并、统计筛选,并利用 openpyxl 实现关键指标的自动化样式高亮与格式化导出。
git:20260426.f0ab496 · audit A · 6,031 stars
numeric-extraction-and-distribution-analysis SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-conditional-formatting/data-bar-formatting/SKILL.md · 从带单位的字符串列中提取数值并清洗,生成包含直方图、饼图、条形图和累积分布图的多维度综合分布可视化图表,用于展示数据的集中趋势与分布特征。
git:20260426.f0ab496 · audit A · 6,031 stars
categorical-comparison-analysis SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-data-analysis/comparison-analysis/SKILL.md · 对两类分类数据进行对比分析,统计数量差异与比例关系并生成可视化图表。
git:20260426.f0ab496 · audit A · 6,031 stars
group-by-analysis SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-data-analysis/group-by-analysis/SKILL.md · 对多 Sheet 的 Excel 文件进行行数统计、大文件 Parquet 转换预处理、数据清洗及分组聚合分析,并生成带样式标记的统计表与可视化图表。
git:20260426.f0ab496 · audit A · 6,031 stars
large-file-kpi-analysis SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-data-analysis/kpi-metric-analysis/SKILL.md · 根据数据量自动选择读取策略(大文件转Parquet),提取关键指标进行单位一致性验证与排序分析,并输出可下载的结果表格。
git:20260426.f0ab496 · audit A · 6,031 stars
pivot-table-cross-analysis SKILL.md skill
opensensenova/sensenova-skills · skills/sn-da-excel-workflow/capability/excel-data-analysis/pivot-table-analysis/SKILL.md · 利用交叉表与热力图对分类数据进行多维度占比分析,适用于奖项分布、绩效评估或市场占有率等结构化数据的清洗与可视化。
git:20260426.f0ab496 · audit A · 6,031 stars

Every file in opensensenova/sensenova-skills

Browse by kind, by grade A, or by owner.