paperreview

What problem does it solve?

Provide a deterministic, script-driven way to submit a final or near-final paper PDF to paperreview.ai and retrieve an external review token and artifacts without using a browser, enabling reproducible submissions and automated result collection.

Core Features & Use Cases

• Dry-run validation mode that checks the PDF file, header, and size without performing network calls to prevent accidental submissions.
• Three-step HTTP workflow: request a presigned upload URL, upload the PDF to S3, and confirm the upload to receive a review token; token writing is optional and configurable.
• Polling utility that queries the review API, saves timestamped JSON and human-readable Markdown next to the original PDF, and supports one-shot checks or continuous polling for up to 48 hours.
• Use cases include automating external second-opinion submissions for conference papers, integrating review retrieval into paper workflows, and debugging submission flows.

Quick Start

Run the submit script in dry-run mode with your PDF to validate inputs, then rerun with submit and an email to perform the actual upload and receive a token.