AnimeTimeline

中文版

A Python tool for crawling and organizing anime broadcast information, supporting retrieval of anime information by year and month, and saving in Markdown format. Includes automated update workflows for daily synchronization of the latest anime data.

Features

• 📅 Dual-mode operation: supports both interactive command line and automated script modes
• ⚡ Smart updates: automatically synchronizes the latest anime data daily (8:00 AM Beijing time)
• 📈 Incremental updates: automatically merges new and old data with intelligent deduplication
• 🕰️ Time range: supports year ranges (e.g., 2010-2024) and month ranges (e.g., 4-7)
• 📦 Data export: generates structured Markdown documents with complete metadata
• 🔁 Failure retry: automatically handles network exceptions with 3 retry attempts
• 🤖 Automatic archiving: creates versioned Pull Requests through GitHub Actions
• 🛡️ Security control: configurable concurrent request limit (default: 3 concurrent requests)

Installation

1. Clone the project locally

   git clone https://github.com/yourusername/AnimeTimeline.git
   cd AnimeTimeline

2. Create and activate virtual environment (recommended)

   python -m venv .venv
   source .venv/bin/activate  # Linux/macOS
   # or
   .venv\Scripts\activate  # Windows

3. Install dependencies

   pip install -r requirements.txt

Usage

Interactive Mode (Manual Operation)

python pull.py interactive

• Enter year range as prompted (e.g., 2010-2024)
• Enter month range (optional, only for single year)
• Data will be saved to Bangumi_Anime.md

Automatic Mode (Script Call)

python pull.py auto --year 2024 --month 3

Parameter	Description	Example
--year	Target year (required)	2024
--month	Target month (optional)	3
--concurrent	Concurrency (default 3)	5

Automated Workflow

# Scheduled tasks:
- Daily automatic updates for current month data
- Monthly supplementary updates for previous month on the 1st day
- Automatic generation of versioned Pull Requests

# Manual triggers:
- Support for manual updates through GitHub interface

Data Storage

• 📂 Data file: Bangumi_Anime.md - Contains the complete anime timeline data
• 🗂️ Version control: Historical versions managed through Git branches
• 📊 Data structure:

| Release Date | Cover | Chinese Title | Japanese Title | Episodes | Rating | Voters |
| --- | --- | --- | --- | --- | --- | --- |
| 2024-03 | ![](CoverURL) | [Title](DetailsPage) | Original Title | 12 | 8.9 | 1523 |

Project Structure

AnimeTimeline/
├── .github/          # Automation configuration
│   └── workflows/
│       └── update-anime.yml  # Daily update workflow
├── pull.py           # Main program (supports dual mode)
├── requirements.txt  # Dependency configuration
├── Bangumi_Anime.md  # Generated data file
├── SECURITY.md       # Security policy
└── README.md         # This documentation

Notes

Network Requests

• Default concurrency is set to 3, to adjust set environment variable:

  export CONCURRENT_REQUESTS=5

• Avoid high-frequency requests, interval time ≥ 1 second

Data Security

• Markdown files use UTF-8 encoding
• Automatic handling of illegal filename characters
• Regular commits of data changes recommended

Exception Handling

• Network errors automatically retried 3 times
• Base year used automatically when date parsing fails
• Cover URL protocol headers automatically completed

Contributing

Code Contributions

1. Fork this repository
2. Create a feature branch

   git checkout -b feature/NewFeature

3. Commit code changes

   git commit -m 'feat: Add awesome feature'

4. Push branch

   git push origin feature/NewFeature

5. Create Pull Request

Data Maintenance

• Participate in data validation through Pull Request reviews
• Report data anomalies in Issues
• Discuss data format improvements in Discussions

License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details

Security Policy

If you discover any security vulnerabilities, please review our security policy document for reporting procedures. We will respond promptly.