[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M77SEJM9K6B8MKPB642BNQJW":3,"skill-same:01M77SEJM9K6B8MKPB642BNQJW":47},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":27,"commitSha":28,"skillDirectory":29,"forksCount":13,"repositoryHtmlUrl":30,"repositoryHomepageUrl":6,"ownerHtmlUrl":31,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":32,"install":33,"resources":46},"01M77SEJM9K6B8MKPB642BNQJW","kreuzberg-cloud",null,"Managed Kreuzberg document intelligence at api.kreuzberg.dev. Use when the user wants cloud extraction with webhook delivery, presigned uploads for large files, document versioning and diffing, sandbox keys, or per-project usage tracking — instead of running the local kreuzberg CLI. Covers authentication, the 12 REST endpoints, request\u002Fresponse shapes, error model, and SDK options.","ConcertoNotes\u002Fcodex-plugins","ConcertoNotes","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F249301288?v=4","01M77NJ0BK2KN5YW0D8RHD99TB","01M77NJ0CCEDPATAY3JTXEWNK5",0,"MIT","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fkreuzberg-cloud\u002Fskills\u002Fkreuzberg-cloud\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: kreuzberg-cloud\ndescription: >-\n  Managed Kreuzberg document intelligence at api.kreuzberg.dev. Use when the\n  user wants cloud extraction with webhook delivery, presigned uploads for\n  large files, document versioning and diffing, sandbox keys, or per-project\n  usage tracking — instead of running the local kreuzberg CLI. Covers\n  authentication, the 12 REST endpoints, request\u002Fresponse shapes, error\n  model, and SDK options.\nlicense: MIT\nmetadata:\n  author: kreuzberg-dev\n  version: \"0.1.0\"\n  repository: https:\u002F\u002Fgithub.com\u002Fkreuzberg-dev\u002Fkreuzberg-cloud\n---\n\n# Kreuzberg Cloud\n\nKreuzberg Cloud is the managed extraction API hosted at\n`https:\u002F\u002Fapi.kreuzberg.dev`. It exposes the same Rust extraction engine as\nthe local `kreuzberg` CLI, with two extras: jobs are asynchronous (webhook\nor polling delivery) and large files go through presigned uploads instead\nof in-band base64.\n\nUse this skill when writing code that:\n\n- Hits `api.kreuzberg.dev` directly via HTTP.\n- Uses the `@kreuzberg\u002Fcloud` (npm) or `kreuzberg-cloud-sdk` (PyPI) SDKs.\n- Configures webhooks, sandbox keys, or usage queries.\n\n## v0.1.0 limitation\n\nThe `kreuzberg-cloud` plugin v0.1.0 ships **skills only — no MCP server**.\nThe `kreuzberg-cloud` CLI binary that hosts the MCP server lands in plugin\nv0.2.0. Until then, prefer one of:\n\n1. The TypeScript SDK (`@kreuzberg\u002Fcloud`) — ESM, tree-shakable, generated\n   from the OpenAPI 3.1 spec.\n2. The Python SDK (`kreuzberg-cloud-sdk`) — sync + async, `from_sandbox()`\n   helper for evaluation.\n3. Raw `curl` — every example below shows the curl form first.\n\n## When cloud vs local\n\n| Situation | Use |\n|---|---|\n| You already have the `kreuzberg` CLI installed and the file is on disk | Local (`kreuzberg` plugin) |\n| File is on a remote URL or in S3 \u002F GCS | Cloud |\n| Need OCR for languages the local Tesseract install doesn't have | Cloud |\n| File is larger than ~50 MB | Cloud (presigned uploads) |\n| Want webhook delivery rather than blocking the caller | Cloud |\n| Batch of mixed documents with shared options | Either; cloud parallelizes server-side |\n| No network access, air-gapped environment | Local |\n| Evaluating before committing to install | Cloud sandbox key |\n\n## Getting an API key\n\nThree options, in order of preference for production:\n\n1. **Production key** — sign up at \u003Chttps:\u002F\u002Fkreuzberg.dev\u002Fcloud>, mint a key\n   from the dashboard. Format: `sk_live_*`.\n2. **Sandbox key** — no signup, 24-hour TTL, 50-page quota, rate-limited to\n   10 keys per IP per 24 hours. Format: `sk_sandbox_*`. See the\n   `sandbox-keys` skill.\n3. **Local `~\u002F.kreuzberg\u002Fcloud.toml`** — for shell sessions, put the key in:\n\n   ```toml\n   # ~\u002F.kreuzberg\u002Fcloud.toml\n   api_key = \"sk_live_...\"\n   ```\n\nThe plugin's `SessionStart` hook checks `KREUZBERG_API_KEY` env var first,\nthen `~\u002F.kreuzberg\u002Fcloud.toml`, and emits a setup reminder if neither is\npresent.\n\n## Authentication\n\nEvery request — except `POST \u002Fv1\u002Fsandbox\u002Fkey` — uses a Bearer token:\n\n```bash\ncurl https:\u002F\u002Fapi.kreuzberg.dev\u002Fv1\u002Fusage \\\n  -H \"Authorization: Bearer $KREUZBERG_API_KEY\"\n```\n\nBoth `sk_live_*` and `sk_sandbox_*` go in the same header. The server\nresolves project context from the key.\n\n## Base URL and versioning\n\n- Base: `https:\u002F\u002Fapi.kreuzberg.dev`\n- Path prefix: `\u002Fv1\u002F` for all extraction, jobs, sandbox, uploads, usage\n  endpoints. Health endpoints (`\u002Fhealthz`, `\u002Freadyz`) are unversioned.\n- The OpenAPI 3.1 spec is published at\n  \u003Chttps:\u002F\u002Fapi.kreuzberg.dev\u002Fopenapi.json>; full reference at\n  \u003Chttps:\u002F\u002Fdocs.kreuzberg.cloud>.\n\n## The 12 endpoints\n\nTwelve operations across seven tag groups:\n\n### health (2)\n\n| Method | Path | Purpose |\n|---|---|---|\n| GET | `\u002Fhealthz` | Liveness — returns 200 if the process is up. |\n| GET | `\u002Freadyz` | Readiness — returns 200 only when downstream deps are healthy. |\n\nNeither requires auth. Use `\u002Freadyz` for uptime monitors and `\u002Fhealthz`\nfor load-balancer health checks.\n\n### extract (1)\n\n| Method | Path | Purpose |\n|---|---|---|\n| POST | `\u002Fv1\u002Fextract` | Submit one or more documents (or URLs) for extraction. |\n\nAccepts `application\u002Fjson` (base64 documents) or `multipart\u002Fform-data`\n(binary file parts). Returns `202 Accepted` with `job_ids` (extraction\njobs) and `crawl_job_ids` (URL-crawl jobs). Pair with `GET \u002Fv1\u002Fjobs\u002F{id}`\nto retrieve results — or supply a `webhook` block to receive them\nasynchronously. See the `offloading-extraction` skill.\n\n### jobs (1)\n\n| Method | Path | Purpose |\n|---|---|---|\n| GET | `\u002Fv1\u002Fjobs\u002F{id}` | Get the current status and (if terminal) result of a job. |\n\nAccepts both extraction job IDs and crawl job IDs. Response shape varies:\nextraction jobs return `JobResponse`, crawl jobs return `CrawlJobResponse`.\nSee the `tracking-cloud-jobs` skill.\n\n### documents (4)\n\n| Method | Path | Purpose |\n|---|---|---|\n| GET | `\u002Fv1\u002Fdocuments\u002F{document_id}` | Latest version of a document with its extraction result. |\n| GET | `\u002Fv1\u002Fdocuments\u002F{document_id}\u002Fdiff?from={v}&to={v}` | Compute a diff between two versions (sync, async fallback on budget). |\n| GET | `\u002Fv1\u002Fdocuments\u002F{document_id}\u002Fdiff\u002F{diff_job_id}` | Poll the status of an async diff job. |\n| GET | `\u002Fv1\u002Fdocuments\u002F{document_id}\u002Fversions` | List all versions of a document (paginated). |\n\nFor applications that re-process the same document over time. Each\nextraction returns a `document_id` that's stable across versions.\n\n### uploads (2)\n\n| Method | Path | Purpose |\n|---|---|---|\n| POST | `\u002Fv1\u002Fuploads\u002Fpresign` | Generate per-file presigned PUT URLs. |\n| POST | `\u002Fv1\u002Fuploads\u002Fconfirm` | Confirm the uploads and start processing. |\n\nThree-step flow for files larger than ~50 MB: presign → PUT to storage →\nconfirm. See the `presigned-uploads` skill.\n\n### sandbox (1)\n\n| Method | Path | Purpose |\n|---|---|---|\n| POST | `\u002Fv1\u002Fsandbox\u002Fkey` | Mint an ephemeral sandbox API key. |\n\n24-hour TTL, 50-page quota, 10 keys per IP per 24 hours. No auth required.\nSee the `sandbox-keys` skill.\n\n### usage (1)\n\n| Method | Path | Purpose |\n|---|---|---|\n| GET | `\u002Fv1\u002Fusage` | Per-project usage statistics and remaining quota. |\n\nAccepts optional `start` and `end` ISO-8601 query params. Defaults to the\ncurrent calendar month. See the `managing-cloud-usage` skill.\n\n## Key request \u002F response shapes\n\n### `ExtractJsonRequest`\n\n```json\n{\n  \"documents\": [\n    {\n      \"filename\": \"invoice.pdf\",\n      \"mime_type\": \"application\u002Fpdf\",\n      \"data\": \"\u003Cbase64>\"\n    }\n  ],\n  \"urls\": [\n    { \"url\": \"https:\u002F\u002Fexample.com\u002Fdocs\" }\n  ],\n  \"options\": {\n    \"extraction_config\": {\n      \"output_format\": \"markdown\",\n      \"ocr\": { \"backend\": \"tesseract\", \"language\": \"eng\" }\n    }\n  },\n  \"crawl_config\": {\n    \"max_depth\": 2,\n    \"max_pages\": 50,\n    \"stay_on_domain\": true\n  },\n  \"webhook\": {\n    \"url\": \"https:\u002F\u002Fexample.com\u002Fwebhook\",\n    \"secret\": \"shared-hmac-secret\",\n    \"metadata\": { \"request_id\": \"abc123\" }\n  }\n}\n```\n\nEither `documents` or `urls` is required (or both). `webhook`, `options`,\nand `crawl_config` are optional.\n\n### `ExtractResponse` (202)\n\n```json\n{\n  \"job_ids\": [\"550e8400-e29b-41d4-a716-446655440000\"],\n  \"crawl_job_ids\": [\"660e9400-f39c-51e5-b827-557766551111\"],\n  \"status\": \"pending\"\n}\n```\n\n### `JobResponse` (200)\n\n```json\n{\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"filename\": \"invoice.pdf\",\n  \"status\": \"completed\",\n  \"created_at\": \"2025-12-21T10:00:00Z\",\n  \"processing_time_ms\": 1234,\n  \"result\": {\n    \"content\": \"Invoice total: $1,234.56\",\n    \"mime_type\": \"text\u002Fmarkdown\",\n    \"tables\": [],\n    \"images\": [],\n    \"metadata\": { \"title\": \"Invoice #12345\" }\n  }\n}\n```\n\n### `JobStatus` enum\n\n```text\nawaiting_upload | pending | processing | chunking | aggregating\n                | completed | partial_success | failed | cancelled\n```\n\nTerminal states: `completed`, `partial_success`, `failed`, `cancelled`.\nStop polling when any of those appears.\n\n### `UsageResponse` (200)\n\n```json\n{\n  \"period_start\": \"2026-05-01\",\n  \"period_end\": \"2026-06-01\",\n  \"total_pages\": 5432,\n  \"total_documents\": 87,\n  \"total_failed\": 2,\n  \"quota_limit\": 100000,\n  \"quota_remaining\": 94568,\n  \"by_mime_type\": {\n    \"application\u002Fpdf\": { \"documents\": 65, \"pages\": 3200, \"failed\": 1 }\n  }\n}\n```\n\n## Error model\n\nAll errors are JSON with at least an `error` string field. Status codes\nfollow REST conventions:\n\n| Status | Meaning | Typical cause |\n|---|---|---|\n| `400` | Bad request | Missing required field, malformed body, invalid UUID. |\n| `401` | Unauthorized | Missing or invalid `Authorization` header. |\n| `404` | Not found | Job \u002F document ID doesn't exist in this project. |\n| `429` | Rate limited | Sandbox-key IP throttle or per-key quota. |\n| `500` | Server error | Database failure, worker crash — retry with backoff. |\n| `503` | Service unavailable | Downstream dep unhealthy — retry. |\n\nThe SDKs surface these as typed exceptions: `AuthError`, `ValidationError`,\n`NotFoundError`, `RateLimitError` (carries `retry_after`), `ServerError`,\n`TimeoutError`, all extending `KreuzbergCloudError` (Python) \u002F\n`KreuzbergError` (TypeScript).\n\n## Concrete examples\n\n### Sandbox onboarding (no signup)\n\n```bash\n# Mint an ephemeral key.\ncurl -X POST https:\u002F\u002Fapi.kreuzberg.dev\u002Fv1\u002Fsandbox\u002Fkey\n# → { \"api_key\": \"sk_sandbox_...\", \"expires_at\": \"...\", \"pages_remaining\": 50 }\n```\n\n```ts\nimport { KreuzbergCloud } from \"@kreuzberg\u002Fcloud\";\nconst client = await KreuzbergCloud.fromSandbox();\nconst result = await client.extractAndWait({\n  file: new Blob([\"Hello world\"], { type: \"text\u002Fplain\" }),\n});\nconsole.log(result.result?.content);\n```\n\n```python\nfrom kreuzberg_cloud import AsyncKreuzbergCloud\nasync with await AsyncKreuzbergCloud.from_sandbox() as client:\n    job = await client.extract_and_wait(file=b\"hello world\")\n    print(job.status, job.result and job.result.content)\n```\n\n### Single-file extract → poll\n\n```bash\n# 1. Submit.\nJOB_ID=$(curl -sX POST https:\u002F\u002Fapi.kreuzberg.dev\u002Fv1\u002Fextract \\\n  -H \"Authorization: Bearer $KREUZBERG_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"documents\": [\n      {\"filename\": \"invoice.pdf\", \"mime_type\": \"application\u002Fpdf\",\n       \"data\": \"'\"$(base64 -w0 invoice.pdf)\"'\"}\n    ],\n    \"options\": {\"extraction_config\": {\"output_format\": \"markdown\"}}\n  }' | jq -r '.job_ids[0]')\n\n# 2. Poll until terminal.\ncurl -s https:\u002F\u002Fapi.kreuzberg.dev\u002Fv1\u002Fjobs\u002F$JOB_ID \\\n  -H \"Authorization: Bearer $KREUZBERG_API_KEY\"\n```\n\n## Other skills\n\n- `offloading-extraction` — full `POST \u002Fv1\u002Fextract` workflow with options.\n- `tracking-cloud-jobs` — polling cadence, webhook signatures.\n- `presigned-uploads` — three-step flow for files >50 MB.\n- `versioning-documents` — retrieve a document, list its versions, diff two versions.\n- `managing-cloud-usage` — quota and per-MIME breakdown.\n- `sandbox-keys` — when to recommend sandbox over production keys.\n\n## References\n\n- API docs: \u003Chttps:\u002F\u002Fdocs.kreuzberg.cloud>\n- OpenAPI spec: \u003Chttps:\u002F\u002Fapi.kreuzberg.dev\u002Fopenapi.json>\n- TypeScript SDK: \u003Chttps:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@kreuzberg\u002Fcloud>\n- Python SDK: \u003Chttps:\u002F\u002Fpypi.org\u002Fproject\u002Fkreuzberg-cloud-sdk\u002F>\n- Pricing and signup: \u003Chttps:\u002F\u002Fkreuzberg.dev\u002Fcloud>\n","# Kreuzberg Cloud\n\nKreuzberg Cloud is the managed extraction API hosted at\n`https:\u002F\u002Fapi.kreuzberg.dev`. It exposes the same Rust extraction engine as\nthe local `kreuzberg` CLI, with two extras: jobs are asynchronous (webhook\nor polling delivery) and large files go through presigned uploads instead\nof in-band base64.\n\nUse this skill when writing code that:\n\n- Hits `api.kreuzberg.dev` directly via HTTP.\n- Uses the `@kreuzberg\u002Fcloud` (npm) or `kreuzberg-cloud-sdk` (PyPI) SDKs.\n- Configures webhooks, sandbox keys, or usage queries.\n\n## v0.1.0 limitation\n\nThe `kreuzberg-cloud` plugin v0.1.0 ships **skills only — no MCP server**.\nThe `kreuzberg-cloud` CLI binary that hosts the MCP server lands in plugin\nv0.2.0. Until then, prefer one of:\n\n1. The TypeScript SDK (`@kreuzberg\u002Fcloud`) — ESM, tree-shakable, generated\n   from the OpenAPI 3.1 spec.\n2. The Python SDK (`kreuzberg-cloud-sdk`) — sync + async, `from_sandbox()`\n   helper for evaluation.\n3. Raw `curl` — every example below shows the curl form first.\n\n## When cloud vs local\n\n| Situation | Use |\n|---|---|\n| You already have the `kreuzberg` CLI installed and the file is on disk | Local (`kreuzberg` plugin) |\n| File is on a remote URL or in S3 \u002F GCS | Cloud |\n| Need OCR for languages the local Tesseract install doesn't have | Cloud |\n| File is larger than ~50 MB | Cloud (presigned uploads) |\n| Want webhook delivery rather than blocking the caller | Cloud |\n| Batch of mixed documents with shared options | Either; cloud parallelizes server-side |\n| No network access, air-gapped environment | Local |\n| Evaluating before committing to install | Cloud sandbox key |\n\n## Getting an API key\n\nThree options, in order of preference for production:\n\n1. **Production key** — sign up at \u003Chttps:\u002F\u002Fkreuzberg.dev\u002Fcloud>, mint a key\n   from the dashboard. Format: `sk_live_*`.\n2. **Sandbox key** — no signup, 24-hour TTL, 50-page quota, rate-limited to\n   10 keys per IP per 24 hours. Format: `sk_sandbox_*`. See the\n   `sandbox-keys` skill.\n3. **Local `~\u002F.kreuzberg\u002Fcloud.toml`** — for shell sessions, put the key in:\n\n   ```toml\n   # ~\u002F.kreuzberg\u002Fcloud.toml\n   api_key = \"sk_live_...\"\n   ```\n\nThe plugin's `SessionStart` hook checks `KREUZBERG_API_KEY` env var first,\nthen `~\u002F.kreuzberg\u002Fcloud.toml`, and emits a setup reminder if neither is\npresent.\n\n## Authentication\n\nEvery request — except `POST \u002Fv1\u002Fsandbox\u002Fkey` — uses a Bearer token:\n\n```bash\ncurl https:\u002F\u002Fapi.kreuzberg.dev\u002Fv1\u002Fusage \\\n  -H \"Authorization: Bearer $KREUZBERG_API_KEY\"\n```\n\nBoth `sk_live_*` and `sk_sandbox_*` go in the same header. The server\nresolves project context from the key.\n\n## Base URL and versioning\n\n- Base: `https:\u002F\u002Fapi.kreuzberg.dev`\n- Path prefix: `\u002Fv1\u002F` for all extraction, jobs, sandbox, uploads, usage\n  endpoints. Health endpoints (`\u002Fhealthz`, `\u002Freadyz`) are unversioned.\n- The OpenAPI 3.1 spec is published at\n  \u003Chttps:\u002F\u002Fapi.kreuzberg.dev\u002Fopenapi.json>; full reference at\n  \u003Chttps:\u002F\u002Fdocs.kreuzberg.cloud>.\n\n## The 12 endpoints\n\nTwelve operations across seven tag groups:\n\n### health (2)\n\n| Method | Path | Purpose |\n|---|---|---|\n| GET | `\u002Fhealthz` | Liveness — returns 200 if the process is up. |\n| GET | `\u002Freadyz` | Readiness — returns 200 only when downstream deps are healthy. |\n\nNeither requires auth. Use `\u002Freadyz` for uptime monitors and `\u002Fhealthz`\nfor load-balancer health checks.\n\n### extract (1)\n\n| Method | Path | Purpose |\n|---|---|---|\n| POST | `\u002Fv1\u002Fextract` | Submit one or more documents (or URLs) for extraction. |\n\nAccepts `application\u002Fjson` (base64 documents) or `multipart\u002Fform-data`\n(binary file parts). Returns `202 Accepted` with `job_ids` (extraction\njobs) and `crawl_job_ids` (URL-crawl jobs). Pair with `GET \u002Fv1\u002Fjobs\u002F{id}`\nto retrieve results — or supply a `webhook` block to receive them\nasynchronously. See the `offloading-extraction` skill.\n\n### jobs (1)\n\n| Method | Path | Purpose |\n|---|---|---|\n| GET | `\u002Fv1\u002Fjobs\u002F{id}` | Get the current status and (if terminal) result of a job. |\n\nAccepts both extraction job IDs and crawl job IDs. Response shape varies:\nextraction jobs return `JobResponse`, crawl jobs return `CrawlJobResponse`.\nSee the `tracking-cloud-jobs` skill.\n\n### documents (4)\n\n| Method | Path | Purpose |\n|---|---|---|\n| GET | `\u002Fv1\u002Fdocuments\u002F{document_id}` | Latest version of a document with its extraction result. |\n| GET | `\u002Fv1\u002Fdocuments\u002F{document_id}\u002Fdiff?from={v}&to={v}` | Compute a diff between two versions (sync, async fallback on budget). |\n| GET | `\u002Fv1\u002Fdocuments\u002F{document_id}\u002Fdiff\u002F{diff_job_id}` | Poll the status of an async diff job. |\n| GET | `\u002Fv1\u002Fdocuments\u002F{document_id}\u002Fversions` | List all versions of a document (paginated). |\n\nFor applications that re-process the same document over time. Each\nextraction returns a `document_id` that's stable across versions.\n\n### uploads (2)\n\n| Method | Path | Purpose |\n|---|---|---|\n| POST | `\u002Fv1\u002Fuploads\u002Fpresign` | Generate per-file presigned PUT URLs. |\n| POST | `\u002Fv1\u002Fuploads\u002Fconfirm` | Confirm the uploads and start processing. |\n\nThree-step flow for files larger than ~50 MB: presign → PUT to storage →\nconfirm. See the `presigned-uploads` skill.\n\n### sandbox (1)\n\n| Method | Path | Purpose |\n|---|---|---|\n| POST | `\u002Fv1\u002Fsandbox\u002Fkey` | Mint an ephemeral sandbox API key. |\n\n24-hour TTL, 50-page quota, 10 keys per IP per 24 hours. No auth required.\nSee the `sandbox-keys` skill.\n\n### usage (1)\n\n| Method | Path | Purpose |\n|---|---|---|\n| GET | `\u002Fv1\u002Fusage` | Per-project usage statistics and remaining quota. |\n\nAccepts optional `start` and `end` ISO-8601 query params. Defaults to the\ncurrent calendar month. See the `managing-cloud-usage` skill.\n\n## Key request \u002F response shapes\n\n### `ExtractJsonRequest`\n\n```json\n{\n  \"documents\": [\n    {\n      \"filename\": \"invoice.pdf\",\n      \"mime_type\": \"application\u002Fpdf\",\n      \"data\": \"\u003Cbase64>\"\n    }\n  ],\n  \"urls\": [\n    { \"url\": \"https:\u002F\u002Fexample.com\u002Fdocs\" }\n  ],\n  \"options\": {\n    \"extraction_config\": {\n      \"output_format\": \"markdown\",\n      \"ocr\": { \"backend\": \"tesseract\", \"language\": \"eng\" }\n    }\n  },\n  \"crawl_config\": {\n    \"max_depth\": 2,\n    \"max_pages\": 50,\n    \"stay_on_domain\": true\n  },\n  \"webhook\": {\n    \"url\": \"https:\u002F\u002Fexample.com\u002Fwebhook\",\n    \"secret\": \"shared-hmac-secret\",\n    \"metadata\": { \"request_id\": \"abc123\" }\n  }\n}\n```\n\nEither `documents` or `urls` is required (or both). `webhook`, `options`,\nand `crawl_config` are optional.\n\n### `ExtractResponse` (202)\n\n```json\n{\n  \"job_ids\": [\"550e8400-e29b-41d4-a716-446655440000\"],\n  \"crawl_job_ids\": [\"660e9400-f39c-51e5-b827-557766551111\"],\n  \"status\": \"pending\"\n}\n```\n\n### `JobResponse` (200)\n\n```json\n{\n  \"id\": \"550e8400-e29b-41d4-a716-446655440000\",\n  \"filename\": \"invoice.pdf\",\n  \"status\": \"completed\",\n  \"created_at\": \"2025-12-21T10:00:00Z\",\n  \"processing_time_ms\": 1234,\n  \"result\": {\n    \"content\": \"Invoice total: $1,234.56\",\n    \"mime_type\": \"text\u002Fmarkdown\",\n    \"tables\": [],\n    \"images\": [],\n    \"metadata\": { \"title\": \"Invoice #12345\" }\n  }\n}\n```\n\n### `JobStatus` enum\n\n```text\nawaiting_upload | pending | processing | chunking | aggregating\n                | completed | partial_success | failed | cancelled\n```\n\nTerminal states: `completed`, `partial_success`, `failed`, `cancelled`.\nStop polling when any of those appears.\n\n### `UsageResponse` (200)\n\n```json\n{\n  \"period_start\": \"2026-05-01\",\n  \"period_end\": \"2026-06-01\",\n  \"total_pages\": 5432,\n  \"total_documents\": 87,\n  \"total_failed\": 2,\n  \"quota_limit\": 100000,\n  \"quota_remaining\": 94568,\n  \"by_mime_type\": {\n    \"application\u002Fpdf\": { \"documents\": 65, \"pages\": 3200, \"failed\": 1 }\n  }\n}\n```\n\n## Error model\n\nAll errors are JSON with at least an `error` string field. Status codes\nfollow REST conventions:\n\n| Status | Meaning | Typical cause |\n|---|---|---|\n| `400` | Bad request | Missing required field, malformed body, invalid UUID. |\n| `401` | Unauthorized | Missing or invalid `Authorization` header. |\n| `404` | Not found | Job \u002F document ID doesn't exist in this project. |\n| `429` | Rate limited | Sandbox-key IP throttle or per-key quota. |\n| `500` | Server error | Database failure, worker crash — retry with backoff. |\n| `503` | Service unavailable | Downstream dep unhealthy — retry. |\n\nThe SDKs surface these as typed exceptions: `AuthError`, `ValidationError`,\n`NotFoundError`, `RateLimitError` (carries `retry_after`), `ServerError`,\n`TimeoutError`, all extending `KreuzbergCloudError` (Python) \u002F\n`KreuzbergError` (TypeScript).\n\n## Concrete examples\n\n### Sandbox onboarding (no signup)\n\n```bash\n# Mint an ephemeral key.\ncurl -X POST https:\u002F\u002Fapi.kreuzberg.dev\u002Fv1\u002Fsandbox\u002Fkey\n# → { \"api_key\": \"sk_sandbox_...\", \"expires_at\": \"...\", \"pages_remaining\": 50 }\n```\n\n```ts\nimport { KreuzbergCloud } from \"@kreuzberg\u002Fcloud\";\nconst client = await KreuzbergCloud.fromSandbox();\nconst result = await client.extractAndWait({\n  file: new Blob([\"Hello world\"], { type: \"text\u002Fplain\" }),\n});\nconsole.log(result.result?.content);\n```\n\n```python\nfrom kreuzberg_cloud import AsyncKreuzbergCloud\nasync with await AsyncKreuzbergCloud.from_sandbox() as client:\n    job = await client.extract_and_wait(file=b\"hello world\")\n    print(job.status, job.result and job.result.content)\n```\n\n### Single-file extract → poll\n\n```bash\n# 1. Submit.\nJOB_ID=$(curl -sX POST https:\u002F\u002Fapi.kreuzberg.dev\u002Fv1\u002Fextract \\\n  -H \"Authorization: Bearer $KREUZBERG_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{\n    \"documents\": [\n      {\"filename\": \"invoice.pdf\", \"mime_type\": \"application\u002Fpdf\",\n       \"data\": \"'\"$(base64 -w0 invoice.pdf)\"'\"}\n    ],\n    \"options\": {\"extraction_config\": {\"output_format\": \"markdown\"}}\n  }' | jq -r '.job_ids[0]')\n\n# 2. Poll until terminal.\ncurl -s https:\u002F\u002Fapi.kreuzberg.dev\u002Fv1\u002Fjobs\u002F$JOB_ID \\\n  -H \"Authorization: Bearer $KREUZBERG_API_KEY\"\n```\n\n## Other skills\n\n- `offloading-extraction` — full `POST \u002Fv1\u002Fextract` workflow with options.\n- `tracking-cloud-jobs` — polling cadence, webhook signatures.\n- `presigned-uploads` — three-step flow for files >50 MB.\n- `versioning-documents` — retrieve a document, list its versions, diff two versions.\n- `managing-cloud-usage` — quota and per-MIME breakdown.\n- `sandbox-keys` — when to recommend sandbox over production keys.\n\n## References\n\n- API docs: \u003Chttps:\u002F\u002Fdocs.kreuzberg.cloud>\n- OpenAPI spec: \u003Chttps:\u002F\u002Fapi.kreuzberg.dev\u002Fopenapi.json>\n- TypeScript SDK: \u003Chttps:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@kreuzberg\u002Fcloud>\n- Python SDK: \u003Chttps:\u002F\u002Fpypi.org\u002Fproject\u002Fkreuzberg-cloud-sdk\u002F>\n- Pricing and signup: \u003Chttps:\u002F\u002Fkreuzberg.dev\u002Fcloud>\n",{"name":5,"license":14,"metadata":23,"description":7},{"author":24,"version":25,"repository":26},"kreuzberg-dev","0.1.0","https:\u002F\u002Fgithub.com\u002Fkreuzberg-dev\u002Fkreuzberg-cloud","main","9ba3c9fadff1092395837bf1502e1b8a7f98b1e1","plugins\u002Fcommunity\u002Fkreuzberg-cloud\u002Fskills\u002Fkreuzberg-cloud","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins","https:\u002F\u002Fgithub.com\u002FConcertoNotes","2026-06-26 10:13:54",{"source":8,"skillName":5,"commands":34,"prompt":44,"zipAvailable":45},[35,38,41],{"tool":36,"command":37},"npx","npx skills add ConcertoNotes\u002Fcodex-plugins --skill kreuzberg-cloud",{"tool":39,"command":40},"bunx","bunx skills add ConcertoNotes\u002Fcodex-plugins --skill kreuzberg-cloud",{"tool":42,"command":43},"pnpm","pnpm dlx skills add ConcertoNotes\u002Fcodex-plugins --skill kreuzberg-cloud","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fcommunity\u002Fkreuzberg-cloud\u002Fskills\u002Fkreuzberg-cloud\u002FSKILL.md",true,[],[48,57,64,72,79,86],{"skillNo":49,"name":50,"nameZh":6,"description":51,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":52,"licenseFileUrl":53,"sourceHtmlUrl":54,"categories":55,"keywords":56,"publishedAt":18},"01M77YB7WW36DS9AERTWP673E0","android-emulator-qa","Use when validating Android feature flows in an emulator with adb-driven launch, input, UI-tree inspection, screenshots, and logcat capture.","Apache-2.0","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Ftest-android-apps\u002Fskills\u002Fandroid-emulator-qa\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Ftest-android-apps\u002Fskills\u002Fandroid-emulator-qa\u002FSKILL.md",[],[],{"skillNo":58,"name":59,"nameZh":6,"description":60,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":61,"categories":62,"keywords":63,"publishedAt":18},"01M77Y7AA8N45G6NM0WJSS2W9C","supabase-postgres-best-practices","Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Fsupabase\u002Fskills\u002Fsupabase-postgres-best-practices\u002FSKILL.md",[],[],{"skillNo":65,"name":66,"nameZh":6,"description":67,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":52,"licenseFileUrl":68,"sourceHtmlUrl":69,"categories":70,"keywords":71,"publishedAt":18},"01M77Y2W5H5YGSW7MYWEJ8HYXD","sentry","Use when the user asks to inspect Sentry issues or events, summarize recent production errors, or pull basic Sentry health data via the Sentry API; perform read-only queries with the bundled script and require `SENTRY_AUTH_TOKEN`.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Fsentry\u002Fskills\u002Fsentry\u002FLICENSE.txt","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Fsentry\u002Fskills\u002Fsentry\u002FSKILL.md",[],[],{"skillNo":73,"name":74,"nameZh":6,"description":75,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":76,"categories":77,"keywords":78,"publishedAt":18},"01M77Y06GV1DAME7PN9KBFHWRX","render-workflows","Sets up, develops, tests, and deploys Render Workflows. Covers first-time scaffolding (via CLI or manual), SDK installation (Python or TypeScript), task patterns (retries, subtasks, fan-out), local development, Dashboard deployment, and troubleshooting. Use when a user wants to set up Render Workflows for the first time, scaffold a workflow service, add or modify workflow tasks, test workflows locally, or deploy workflows to Render.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Frender\u002Fskills\u002Frender-workflows\u002FSKILL.md",[],[],{"skillNo":80,"name":81,"nameZh":6,"description":82,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":83,"categories":84,"keywords":85,"publishedAt":18},"01M77Y01A6RJA8VYT7CZ2TVETF","render-web-services","Configures Render web services—port binding, TLS, health checks, custom domains, auto-deploy, PR previews, persistent disks, and deploy lifecycle. Use when the user needs to set up a web service, fix health check failures, add a custom domain, configure zero-downtime deploys, or troubleshoot port binding issues.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Frender\u002Fskills\u002Frender-web-services\u002FSKILL.md",[],[],{"skillNo":87,"name":88,"nameZh":6,"description":89,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":9,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":18},"01M77XZW1AZ6B6NZTWWFVY72T3","render-static-sites","Deploys and configures static sites on Render's global CDN—build commands, publish paths, SPA routing, redirects, custom headers, and PR previews. Use when the user needs to deploy a static site, set up a React\u002FVue\u002FHugo\u002FGatsby frontend, configure SPA fallback routing, add redirect rules, customize response headers, or choose between a static site and a web service for their frontend. Trigger terms: static site, CDN, SPA, single-page app, React deploy, Vue deploy, Hugo, Gatsby, Docusaurus, Jekyll, staticPublishPath.","https:\u002F\u002Fgithub.com\u002FConcertoNotes\u002Fcodex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fofficial\u002Frender\u002Fskills\u002Frender-static-sites\u002FSKILL.md",[],[]]