anakin-sdk 0.1.0

Official Python SDK for Anakin (anakin.io) — web scraping, crawling, search, and Wire actions.

anakin-sdk

Official Python SDK for Anakin — web scraping, crawling, search, and Wire actions.

Status: alpha (v0.1.x). Public API may change between minor versions until v1.0.

Install

pip install anakin-sdk

Note: distribution name is anakin-sdk on PyPI; the Python import name is anakin. So you pip install anakin-sdk but from anakin import Anakin in your code.

Quickstart

from anakin import Anakin

client = Anakin(api_key="ak-...")  # or set ANAKIN_API_KEY env var

# Scrape a single URL
doc = client.scrape("https://example.com", formats=["markdown"])
print(doc.markdown)

# Discover URLs on a site
sitemap = client.map("https://example.com", limit=200)
print(sitemap.links)

# Crawl pages and get content
crawl = client.crawl("https://example.com", max_pages=20)
for page in crawl.pages:
    print(page.url, len(page.markdown or ""))

The SDK polls long-running jobs internally — you get the final result back from a single sync method call. No job IDs to manage, no polling loops to write.

Configuration

client = Anakin(
    api_key="ak-...",          # or ANAKIN_API_KEY env var
    timeout=60.0,              # per-request HTTP timeout
    max_retries=4,             # retries on 429/5xx
    poll_interval=1.0,         # initial polling delay
    poll_max_interval=10.0,    # max polling delay
    poll_timeout=300.0,        # total wait before JobTimeoutError
)

Errors

from anakin import (
    AnakinError,                # base for everything below
    AuthenticationError,        # bad/missing API key
    InsufficientCreditsError,   # 402 (exposes .balance, .required)
    InvalidRequestError,        # 400
    JobFailedError,             # job came back with status="failed"
    JobTimeoutError,            # poll_timeout exceeded
    RateLimitError,             # 429 (exposes .retry_after)
    ServerError,                # 5xx after retries
    NetworkError,               # DNS/connection/timeout
)

Development

pip install -e ".[dev]"
ruff check .
mypy src/
pytest

License

Apache 2.0. See LICENSE.