ads-paper-searchlisted

# NASA ADS Paper Search ## Overview Search the NASA Astrophysics Data System (ADS / SciX) — the standard literature database for astronomy, astrophysics, space physics, and planetary science (~15M records). This skill wraps the ADS API (`https://api.adsabs.harvard.edu/v1`) via a bundled stdlib-only Python script. ## Setup (one-time, per user) A personal ADS API token is required (free). The script looks for it in: 1. `ADS_API_TOKEN` environment variable (use this on claude.ai or in CI) 2. `~/.ads/token` — written by the `setup` subcommand below If a command exits with "No ADS API token found", relay its setup steps to the user and ask for their token: 1. Create a free account at https://ui.adsabs.harvard.edu/ 2. Copy the token from https://ui.adsabs.harvard.edu/user/settings/token 3. Run `python3 scripts/ads.py setup THEIR_TOKEN` — this verifies the token against the API and saves it to `~/.ads/token` (mode 600), so setup never needs to happen again. Never hardcode a token into this skill or share one token between users — ADS tokens are personal and rate limits (5000 requests/day) are per-account. ## Quick reference Run all commands with `python3 scripts/ads.py` (paths relative to this skill's directory). Add `--json` for raw JSON, `-h` for full options. | Task | Command | |------|---------| | Search papers | `search 'QUERY' --rows 10 --sort "citation_count desc"` | | Search with abstracts | `search 'QUERY' --abstract` | | Look up bibcode(s) | `get 2016SSRv.