comike-cli 0.1.0

CLI tool for Comiket WebCatalog with natural language interface

comike-cli

A Python CLI tool for browsing Comiket WebCatalog with a Claude Code-like interactive interface.

Overview

Search and browse Comiket circle information from your terminal using the Circle.ms WebCatalog API.

Features

Circle Search & Browse

• Search by circle name
• Filter by genre and hall
• View circle details
• Display circle cut images (Braille Unicode art)

Work Search

• Keyword search by work name/description
• Filter by new/existing releases
• View work details

Favorites Management

• Add/remove/update favorite circles
• Organize with color labels (9 colors)
• Add memos
• View favorites list

Event Information

• Get event list
• Access past event data

Requirements

• Python 3.10+
• Circle.ms developer account (required for API access)

Installation

pip install comike-cli

Or install from source:

git clone https://github.com/m96-chan/comike-cli.git
cd comike-cli
pip install -e .

Setup

1. Register as a developer at Circle.ms to obtain Client ID and Client Secret
2. Set credentials in .env file

cp .env.example .env
# Edit .env and set CIRCLE_MS_CLIENT_ID, CIRCLE_MS_CLIENT_SECRET, and OPENAI_API_KEY

Usage

# Start interactive mode
comike

# Example queries (in natural language)
# "Search for circles with 東方"
# "Show my favorites"
# "Add this circle to favorites"

# Commands
# /help  - Show help
# /clear - Clear conversation history
# /quit  - Exit

Development

# Install with dev dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Lint
ruff check .

License

MIT

Important Notes

• Data obtained via the API must not be redistributed or used for purposes other than app development
• Bulk export functionality for circle information is prohibited
• Web application development is not permitted
• API specification redistribution/publication is prohibited

See the Developer Guidelines for details.