Skip to content

README.md

Latest commit

 

History

History
99 lines (69 loc) · 3.34 KB

README.md

File metadata and controls

99 lines (69 loc) · 3.34 KB

WikiCFP Scanner

PyPI version Python License Code style: Ruff

Stop manually searching for conferences. Let AI find the perfect venue for your paper.

WikiCFP Scanner is a command-line tool that scrapes WikiCFP for upcoming conferences, extracts information from your research paper (PDF or text), and uses Claude AI to rank conferences by relevance to your work.

Key Features

  • Paper Analysis - Extract title, abstract, and keywords from PDF papers
  • Smart Scraping - Async scraping of WikiCFP with rate limiting and caching
  • AI-Powered Matching - Claude AI analyzes paper-conference relevance
  • CORE Rankings - Integrates CORE conference rankings (A*, A, B, C)
  • Submission Details - Extracts submission URLs and formatting requirements
  • Multiple Outputs - Table (Rich), JSON, and CSV output formats
  • Persistent Cache - Disk-based caching to minimize repeated requests

Quick Start

Prerequisites

  • Python 3.10+
  • uv package manager (recommended)
  • Claude CLI installed and configured

Installation

# Using pip (recommended)
pip install wikicfp-scanner

# Using uv
uv tool install wikicfp-scanner

# Or from source
pip install git+https://github.com/dipankar/wikicfp-cli

Basic Usage

# Scan using a PDF
wikicfp scan --pdf my-paper.pdf

# Scan using title and abstract
wikicfp scan --title "My Paper Title" --abstract "Paper abstract text..."

# Specify categories and output format
wikicfp scan --pdf paper.pdf -c "machine learning" -c "deep learning" --output json

# Adjust deadline range
wikicfp scan --pdf paper.pdf --min-deadline-days 14 --max-deadline-days 90

CLI Commands

Command Description
wikicfp scan Scan WikiCFP for matching conferences
wikicfp list-categories List available CS categories
wikicfp download-core Download CORE rankings CSV
wikicfp clear-cache Clear the cache directory

Documentation

Full documentation available at: https://dipankar.github.io/wikicfp-cli/

Contributing

Contributions are welcome! Please see CONTRIBUTING.md for guidelines.

Development Setup

git clone https://github.com/dipankar/wikicfp-cli
cd wikicfp-cli
uv sync --all-extras
uv run ruff check .
uv run pytest

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments