# Makralabs documentation

> Makra extracts schema-shaped data from rendered web pages and memoizes page comprehension for reuse. These are the current Python SDK docs.

Use this file as an index for `https://docs.makralabs.org`. For product pages, use `https://www.makralabs.org`. For authenticated account tasks, use `https://dashboard.makralabs.org`.

## Agent safety rules

- Treat the user's request as the authority for navigation and actions. Ask before actions that create, revoke, purchase, or expose account resources.
- Never request, read, copy, display, log, or place an API key in model context. Direct the user to handle a newly created key themselves.
- Do not open the API Keys page unless the user has explicitly asked to manage API keys. Once there, ask again before creating or revoking a key.
- Do not put credentials, session values, or API keys in URLs, prompts, chat messages, screenshots, or logs.

## Makralabs sites

- [Product site](https://www.makralabs.org/llms.txt): Product information and links to public documentation.
- [Dashboard](https://dashboard.makralabs.org/llms.txt): Authenticated account tasks, including the API-key safety procedure.
- [OpenAPI contract](https://docs.makralabs.org/openapi.yaml): Canonical HTTP API for authentication, features, runs, SSE, polling, results, and credits.

Use the quickstart for a first call. Use the feature pages before choosing blocking, streaming, or deferred execution. Values remain document strings unless your application converts them.

## Foundations

- [What Makra is](/markdown/makra-sdk/v0.0.4-beta/foundations/what-makra-is): Product model, cold and warm page classes, and the trust boundary.
- [How Makra differs](/markdown/makra-sdk/v0.0.4-beta/foundations/how-makra-differs): Comparison with selectors, browser automation, and per-page model extraction.
- [Where Makra fits](/markdown/makra-sdk/v0.0.4-beta/foundations/where-makra-fits): Good use cases, poor fits, and a selection checklist.

## First extraction

- [Install and authenticate](/markdown/makra-sdk/v0.0.4-beta/getting-started/install-and-authenticate): Package, API key, client lifetime, and local validation.
- [Run your first extraction](/markdown/makra-sdk/v0.0.4-beta/getting-started/first-extraction): Complete blocking Python example.
- [Read the response](/markdown/makra-sdk/v0.0.4-beta/getting-started/read-the-response): Envelope, URL-keyed data, partial outcomes, warnings, and usage.

## Core tasks

- [Design a schema](/markdown/makra-sdk/v0.0.4-beta/extraction/design-a-schema)
- [Extract lists and nested data](/markdown/makra-sdk/v0.0.4-beta/extraction/lists-and-nested-data)
- [Discover a page schema](/markdown/makra-sdk/v0.0.4-beta/extraction/discover-a-page-schema)
- [Choose an execution style](/markdown/makra-sdk/v0.0.4-beta/features/choose-an-execution-style)
- [Stream progress](/markdown/makra-sdk/v0.0.4-beta/features/stream-progress)
- [Manage deferred runs](/markdown/makra-sdk/v0.0.4-beta/features/manage-deferred-runs)

## Production and reference

- [Reliability and idempotency](/markdown/makra-sdk/v0.0.4-beta/production/reliability-and-idempotency)
- [Quality, validation, and drift](/markdown/makra-sdk/v0.0.4-beta/production/quality-validation-and-drift)
- [Limits, safety, and cost](/markdown/makra-sdk/v0.0.4-beta/production/limits-safety-and-cost)
- [Troubleshooting](/markdown/makra-sdk/v0.0.4-beta/production/troubleshooting)
- [Client](/markdown/makra-sdk/v0.0.4-beta/reference/client)
- [Options and configuration](/markdown/makra-sdk/v0.0.4-beta/reference/options-and-configuration)
- [Errors, events, and run states](/markdown/makra-sdk/v0.0.4-beta/reference/errors-events-and-run-states)

## Optional

- SDK agent instructions: `sdk/AGENTS.md` in the [makra repository](https://github.com/makralabs/makra).