ssq — 双色球开奖数据抓取工具

从中彩网官方 JSONP 接口抓取双色球历史开奖数据，支持按期数或日期范围筛选，自动导出为 Markdown 表格文件。

---

特性

• 直接调用官方接口，无需浏览器/Playwright，依赖极轻
• 自动分页，单次可抓取任意期数
• 支持按开始 / 结束日期筛选
• 自动重试（最多 3 次），忽略系统代理，网络稳定性更好
• 导出标准 Markdown 表格，方便阅读和二次处理

---

环境要求

• Python 3.10+
• requests（见下方安装方式）

---

快速开始

方式 A：虚拟环境（推荐）

git clone https://github.com/your-username/ssq.git
cd ssq

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
.venv/bin/python fetch_ssq.py

方式 B：直接用系统 python3（不用 .venv）

macOS 上若通过 Homebrew 安装 Python，直接执行 pip install 会报 externally-managed-environment（PEP 668 保护）。需安装到用户目录：

cd ssq
python3 -m pip install --user --break-system-packages -r requirements.txt
python3 fetch_ssq.py

只需安装一次。之后在该机器上可直接 python3 fetch_ssq.py，无需激活虚拟环境。
若终端曾 source .venv/bin/activate，请先 deactivate，再确认 which python3 不是 .venv 里的路径。

---

使用方法

# 抓取最近 100 期（默认）
python3 fetch_ssq.py

# 自定义抓取期数
python3 fetch_ssq.py -n 50

# 按日期范围筛选
python3 fetch_ssq.py -s 2025-01-01 -e 2025-12-31

# 指定输出文件名
python3 fetch_ssq.py -o 我的数据.md

若使用虚拟环境，把上面的 python3 换成 .venv/bin/python 即可。

参数说明

参数	简写	默认值	说明
--count	-n	100	抓取期数
--start-date	-s	无	开始日期，格式 YYYY-MM-DD
--end-date	-e	无	结束日期，格式 YYYY-MM-DD
--output	-o	自动生成	输出文件名（默认含时间戳）

---

导出格式示例

# 双色球开奖数据

> 共 10 期，数据来源：中彩网
> 导出时间：2026-06-01 08:29:32

| 期号    | 开奖日期   | 星期   | 红球号码                          | 蓝球   |
| :-----: | :--------: | :----: | :-------------------------------: | :----: |
| 2026061 | 2026-05-31 | 星期日 | `01` `04` `05` `15` `23` `28`   | **07** |
| 2026060 | 2026-05-28 | 星期四 | `07` `09` `10` `16` `22` `27`   | **11** |

---

打印输出

导出的 Markdown 文件可直接转换为打印稿：

1. 浏览器打印：用 Typora、Obsidian 或 VS Code 的 Markdown 预览打开文件，按 Cmd+P（macOS）/ Ctrl+P（Windows）调出打印对话框，连接打印机后直接打印。
2. 转 PDF 再打印：使用 Typora 导出为 PDF（文件 → 导出 → PDF），或命令行借助 pandoc 转换：

   pandoc 双色球开奖数据_*.md -o 双色球开奖数据.pdf

   再用系统 PDF 阅读器打印。
3. 在线渲染打印：将 .md 文件内容粘贴到 Markdown to PDF 等在线工具，生成 PDF 后打印。

建议打印时选择「横向」纸张方向，表格列宽更易于阅读。

---

数据来源

类型	地址
开奖结果页面	https://www.zhcw.com/kjxx/ssq/
数据接口（JSONP）	https://jc.zhcw.com/port/client_json.php

---

项目结构

ssq/
├── fetch_ssq.py          # 主脚本
├── requirements.txt      # Python 依赖
└── 双色球开奖数据_*.md   # 导出的数据文件（按时间戳命名）

---

License

MIT