Metadata-Version: 2.4
Name: anicatch
Version: 0.1.2
Summary: Anime torrent scraper for miobt.com — browse by season, search, and download via BitTorrent
Project-URL: Homepage, https://github.com/isongxw/anicatch
Project-URL: Repository, https://github.com/isongxw/anicatch
Author: isongxw
License: MIT
Keywords: anime,bittorrent,download,miobt,scraper,torrent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Internet :: WWW/HTTP
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: browserforge>=1.2.4
Requires-Dist: curl-cffi>=0.15.0
Requires-Dist: libtorrent>=2.0.11
Requires-Dist: loguru>=0.7.0
Requires-Dist: playwright>=1.58.0
Requires-Dist: pydantic>=2.0.0
Requires-Dist: scrapling>=0.2.0
Requires-Dist: textual>=0.44.0
Description-Content-Type: text/markdown

# AniCatch - 动漫资源爬虫

抓取 miobt.com 动漫资源，支持搜索、浏览、BT 下载。

[English](README.en.md) | 中文

## 致谢

感谢 [miobt.com](https://miobt.com) 提供动漫资源索引。

## 安装

### PyPI（推荐）

```bash
pipx install anicatch        # 推荐：隔离安装
pip install anicatch         # 或标准 pip
uv tool install anicatch     # 或 uv
```

### 直接运行（零安装）

```bash
uvx anicatch --search "JOJO"
```

### 开发安装

```bash
git clone https://github.com/isongxw/anicatch.git
cd anicatch
uv sync
```

## 使用

提供两种模式：

### TUI 模式（人机交互）

```bash
anicatch
```

- 浏览季度新番（左右切换季度、月份）
- 键盘导航查看番剧详情和 magnet 链接
- 支持下载选中的资源

### CLI 模式（自动化 / Agent 调用）

```bash
anicatch --search "JOJO"                                    # 搜索
anicatch --search "JOJO" --download --index 0                # 搜索并下载
anicatch --search "JOJO" --download -o ~/Downloads           # 下载到指定目录
anicatch --download "https://miobt.com/show-xxx.html"        # 直接下载
anicatch --seasons                                          # 列出所有季度
anicatch --season                                           # 浏览当前季度
anicatch --season 1 --download --index 0                     # 下载指定季度番剧
```

## 输出

- 搜索结果：打印到 stdout，同时保存 `output/` 目录
- 下载文件：`downloads/` 目录

## 项目结构

```
src/anicatch/
├── __main__.py      # CLI/TUI 入口
├── tui.py           # TUI 界面
├── scraper.py       # 爬取与解析
├── downloader.py    # BT 下载
├── seasons.py       # 季度发现
├── models.py        # 数据模型
├── config.py        # 配置常量
└── utils.py         # 工具函数
```
