CNInfo A-Share Filing Search and Batch Download
Paste the following prompt into your AI chat to install this skill:
Please install @user_457a1277/cninfo-filing-scraper according to https://skillhub.cn/install/skillhub.md.
About this skill
What Problem It Solves
When doing audit preparation, investment research, or compliance checks, you often need a local working set of CNInfo A-share disclosures for a specific ticker, date range, and announcement type. Manually paging through the web UI, filtering categories, and downloading PDFs is easy to miss and hard to reconcile against workpapers. This skill wraps search, download, and metadata export into a script that targets CNInfo’s public JSON API directly.
How It Works
The workflow centers on scripts/cninfo_scraper.py. Use search to retrieve announcement metadata or download to fetch PDFs after applying filters. Parameters such as --stock, --from, --to, --category, --search-key, and --plate cover Shenzhen, Shanghai, BSE, ChiNext, and STAR Market scopes. Records include fields like secCode, title, announcementDate, categoryDescription, pdfUrl, and detailUrl, which helps deduplicate by announcementId and trace filings. Output can be text or xlsx, making it easier to import announcement lists into Excel for indexing.
Boundaries and Caveats
It is intended for filing search, bulk PDF retrieval, and structured list export; it does not perform full-text parsing, OCR, financial metric extraction, or legal analysis. CNInfo has stricter anti-scraping behavior, and the script uses roughly a 1.5-second request interval, so do not reduce it. Some direct PDF links may require cookies; if you see repeated 403 responses, add browser cookies to the request headers. Attachments are not always PDFs—some are HTML or XLSX—so check adjunctType before assuming a file can be downloaded with the default PDF flow.
Use Cases
- Prepare audit workpapers by searching annual and semiannual reports by ticker and period, then batch-downloading PDFs.
- Track ChiNext earnings preannouncements and equity distributions by exporting filtered filings to Excel.
- Collect BSE clarification/apology and risk warning announcements by date range and category.
- Find a company's convertible bond or capital increase announcements by title keyword and download original PDFs.
Best For
- Audit workpaper preparer: needs to download filings for a client by category and generate a listing.
- A-share equity analyst: needs to filter disclosures by board and announcement type, then export to Excel.
- Compliance or legal reviewer: needs to check completeness and timeliness of company announcements in a period.
- Data engineer: needs to consume public JSON results and store metadata plus PDF links in a pipeline.
Related Skills
Covers literature review, data analysis, visualization, drug discovery, paper writing, and grant writing workflows.
A retrieval assistant for Chinese laws and regulations, supporting semantic queries, validity checks, clause location, and regulation comparison with CLI-based output.
Run questionnaire-based tax risk scans that generate red/orange/yellow alerts with industry templates, policy references, remediation actions, and local trend tracking.
A contract review assistant for legal and business teams that extracts clauses, flags risks, compares versions, and generates opinion reports with a built-in legal knowledge base.