---

name: wayback-submit description: Submit a URL to the Wayback Machine for archiving. Use when the user wants to archive a webpage, save a page to the Internet Archive, preserve a URL, or create a snapshot.

Submit URL to Wayback Machine

Submit a URL to the Internet Archive's Wayback Machine using the Save Page Now 2 (SPN2) API.

Usage

Copynpx tsx scripts/submit.ts <url> [options]

Arguments

Options

Output

When submission succeeds:

Copy✓ Archive submitted successfully
  Job ID: spn2-abc123...
  Check status: https://web.archive.org/save/status/spn2-abc123...

  Waiting for capture...
  ✓ Capture complete
  URL: https://web.archive.org/web/20240115123456id_/https://example.com

Script Execution (Preferred)

Copynpx tsx scripts/submit.ts <url> [options]

Options:

• --no-raw - Include Wayback toolbar in archived URL
• --key=ACCESS:SECRET - Use API authentication

Run from the wayback plugin directory: ~/.claude/plugins/cache/wayback/

Authentication

Get API keys at https://archive.org/account/s3.php (requires free account).

Header format:

CopyAuthorization: LOW {access_key}:{secret_key}

Rate Limits

SPN2 API

Endpoint: POST https://web.archive.org/save

Basic Request

Copycurl -X POST https://web.archive.org/save \
  -H "Accept: application/json" \
  -H "Authorization: LOW myaccesskey:mysecret" \
  -d "url=https://example.com"

Parameters

Response

Success:

Copy{
  "url": "https://example.com",
  "job_id": "spn2-abc123..."
}

Check Job Status

Copycurl "https://web.archive.org/save/status/{job_id}" \
  -H "Authorization: LOW myaccesskey:mysecret"

Pending:

Copy{"status": "pending", "resources": []}

Success:

Copy{
  "status": "success",
  "timestamp": "20240115123456",
  "original_url": "https://example.com",
  "resources": ["https://example.com/style.css"],
  "outlinks": {},
  "screenshot": "https://web.archive.org/web/.../screenshot.png"
}

Error codes: error:blocked-url, error:too-many-daily-captures, error:soft-time-limit-exceeded, error:invalid-host-resolution

Check Your Quota

Copycurl "https://web.archive.org/save/status/user" \
  -H "Authorization: LOW myaccesskey:mysecret"

Returns: {"available": 99950, "processing": 2}

Simple Method (No Auth)

For quick one-off saves without authentication:

Copyhttps://web.archive.org/save/{URL}

Lower rate limits apply (6 concurrent, 4k daily).

1. Use delay_wb_availability=1 for batch jobs (reduces server load)
2. Check job status for captures that take time (JS-heavy pages)
3. Use capture_screenshot=1 for visual verification