airtable-user-scrapinglisted

# Airtable User Scraper Skill ## Purpose This skill covers running `airtable-scrape-users` to extract user/collaborator data from Airtable bases grouped by workspace. Airtable's API does not expose collaborator data on the Team plan; this tool scrapes it from the web UI instead. ## ⚠️ Important: Acceptable Use Policy **This tool violates Airtable's [Acceptable Use Policy](https://www.airtable.com/company/aup).** Always warn the user and obtain explicit acknowledgment before proceeding. ## Prerequisites Install Playwright's browser (first time only): ```bash playwright install chromium # Dependencies are handled automatically by uv on first run ``` ## Workflow ### Step 1: Login (once per ~30 days) Opens a browser for manual authentication. Auth cookies are saved to `output/airtable_auth_state.json`. ```bash airtable-scrape-users --login ``` Re-run `--login` if scraping starts failing (cookies expire after ~30 days). ### Step 2: Discover bases and save workspace config (once, or when bases change) Fetches all accessible bases from the Airtable API and saves workspace groupings to `output/airtable_scraper_config.json`. ```bash export AIRTABLE_API_KEY=patXXXXXXXXXX airtable-scrape-users --from-api --save-config ``` **Tip:** Place a `.env` file in the directory you run the command from. It is loaded automatically. ```dotenv # .env AIRTABLE_API_KEY=patXXXXXXXXXX ``` If the project manages secrets with [fnox](https://github.com/jdx/fnox) (a `fnox.toml` in scope), w