---
name: cninfo-to-notebooklm
description: Use when user wants to analyze China A-share stock reports, upload annual/quarterly reports to NotebookLM, or research a Chinese listed company's financials
---

# CNinfo to NotebookLM

## Overview

Download annual and periodic reports for China A-share stocks from cninfo.com.cn and upload them to NotebookLM for AI-powered analysis with a specialized "Financial Analyst" persona.

## When to Use

- User provides a China A-share stock name or code
- User wants to analyze a company's financial reports
- User asks to "download reports" or "research" a Chinese stock
- User wants to upload stock reports to NotebookLM

## Core Workflow

```text
User provides stock name/code
        ↓
1. Look up stock in database
        ↓
2. Download reports from cninfo:
   - Last 5 years annual reports (年度报告)
   - Current year: Q1, semi-annual, Q3 reports
        ↓
3. Create NotebookLM notebook
        ↓
4. Configure "Financial Analyst" persona with custom prompt
        ↓
5. Upload all PDFs as sources
        ↓
6. Return notebook ID ✅
```

## Step-by-Step Instructions

### Step 0: Environment Setup (First Run Only)

**Crucial**: Before running the script, verify the environment is ready.

1. **Check Dependencies**: Verify if the dependencies are installed (specifically `notebooklm` and `playwright`).
2. **Install**: If dependencies are missing or this is the first run, execute the installation script:

   ```bash
   chmod +x install.sh && ./install.sh
   ```

3. **Authenticate**: Ensure the user has authenticated with NotebookLM (`notebooklm login`). If not, ask them to do so.

### Step 1: Run Main Orchestration Script

Run the script from the skill directory:

```bash
python3 scripts/run.py <stock_code_or_name>
```

Examples:

- `python3 scripts/run.py 600350`
- `python3 scripts/run.py 山东高速`

This script handles everything:

1. Downloads reports to a temp directory.
2. Creates a NotebookLM notebook.
3. Configures the notebook with `assets/financial_analyst_prompt.txt`.
4. Uploads all PDFs.
5. Cleans up temp files.

### Step 2: Report to User

Provide:

- ✅ Number of reports downloaded & uploaded
- 📚 NotebookLM notebook ID
- 💡 Remind user the notebook creates a "Financial Analyst" persona for deep analysis.

## Configuration

The skill uses a custom system prompt located at:
`assets/financial_analyst_prompt.txt`

This prompt configures NotebookLM to act as a "Financial Report Analyst" based on "Hand-holding Financial Reporting" methodology.

## Error Handling

| Error | Solution |
| :--- | :--- |
| Stock not found | Check if code is valid A-share (000xxx, 002xxx, 300xxx, 600xxx, etc.) |
| NotebookLM CLI not found | Ensure `notebooklm-py` matches `requirements.txt` and is in PATH |
| Auth missing | Run `notebooklm login` to authenticate via browser |
| Upload failed | Check network connection and NotebookLM service status |

## Dependencies

- Python 3.8+
- `httpx` package
- `notebooklm-py` package
- `playwright` (for authentication)

## Quick Reference

| Report Type | Category Code | Period |
| :--- | :--- | :--- |
| Annual | `category_ndbg_szsh` | Previous 5 years |
| Semi-Annual | `category_bndbg_szsh` | Current year |
| Q1 Report | `category_yjdbg_szsh` | Current year |
| Q3 Report | `category_sjdbg_szsh` | Current year |