Python SDK

uv add parse-sdk      # runtime + `parse` CLI, into your project's .venv
uv run parse init     # one-time: authenticate, scaffold parse_apis, first sync

uv run parse login                      # browser sign-in (OAuth 2.1 + PKCE) — the default
uv run parse login --no-web             # paste an API key (dashboard: Settings → API Keys)
uv run parse login --api-key YOUR_KEY   # non-interactive (CI, agents)

uv run parse list               # see your account APIs and their slugs
uv run parse add my_zillow_api  # track it, then sync

uv run parse search walmart                     # find it
uv run parse add --marketplace walmart-com-api  # add a pinned snapshot

from parse_apis.walmart_com_api import Walmart, Sort, ProductNotFound
from parse_apis import RateLimitError   # runtime errors, re-exported

client = Walmart()                      # picks up your `parse login` credentials

# Typed resources + methods, with autocomplete and typed responses
for product in client.productsummaries.search(query="laptop", sort=Sort.PRICE_LOW, limit=5):
    print(product.name, product.price, product.rating)

# Typed errors
try:
    client.products.get(product_id="0000000000")
except ProductNotFound as exc:
    print(f"not found: {exc.product_id}")
except RateLimitError:
    ...

uv run python app.py

parse_apis/
  pyproject.toml               # committed: name="parse-apis", pins parse-sdk==X
  AGENTS.md  CLAUDE.md         # committed "start here" pointer (survives a fresh clone)
  src/parse_apis/
    __init__.py                # committed scaffold (re-exports runtime errors)
    py.typed                   # committed
    walmart_com_api/           # generated client + README.md + example.py (gitignored)
    _manifest.json             # generated (gitignored)
    AGENTS.md  CLAUDE.md       # generated cross-API index (gitignored)

[tool.parse]
# Account APIs to track. Omit `apis` entirely to track ALL of them;
# an empty list means none.
apis = ["my_zillow_api"]

# Marketplace APIs downloaded into this repo, each pinned to a version.
[[tool.parse.marketplace]]
slug = "walmart-com-api"
version = 3

uv run parse sync           # generate/refresh exactly what the manifest declares
uv run parse sync --check   # CI dry run: report drift without writing, exit 1 on any finding
uv run parse clean          # remove the generated payload, keep the committed scaffold

uv run parse list --json    # [{ "id", "slug", "name", "modeled", "endpoints", "resources" }, …]
uv run parse sync --json    # { "written", "skipped", "removed", "quarantined", "failures" }
uv run parse doctor --json  # { "ok": true|false, "findings": [ … ] }

Set up and use the Parse Python SDK in this project.

1. Ensure this is a uv project — if there is no pyproject.toml, run `uv init`.
2. Install the SDK: `uv add parse-sdk`.
3. Authenticate: if PARSE_API_KEY is not set, get a key from the Parse
   dashboard (parse.bot → Settings → API Keys) and run
   `uv run parse login --api-key <KEY>`.
4. Initialize: `uv run parse init` (now non-interactive — credentials exist).
5. List the APIs this key can call: `uv run parse list --json`.
6. Add the API(s) I need by slug: `uv run parse add <slug>` (or
   `uv run parse add --marketplace <id|slug|url>` for a marketplace API).
   This regenerates parse_apis.
7. Read `parse_apis/src/parse_apis/<slug>/README.md` for the exact import line, then write
   code that imports the typed client from `parse_apis.<module>` and calls its
   resources and methods. Catch typed errors re-exported from `parse_apis`.
8. Run it with `uv run python <file>.py`.

Always invoke the CLI as `uv run parse …`. Prefer `--json` output when parsing
results. If imports or editor autocomplete don't resolve, run
`uv run parse doctor --fix`.