[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M6MHZFWS7V6QCHTKDN8NGMCR":3,"skill-same:01M6MHZFWS7V6QCHTKDN8NGMCR":83},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":31,"publishedAt":54,"linkOnly":55,"markdownContent":56,"markdownBody":57,"frontMatter":58,"refName":59,"commitSha":60,"skillDirectory":61,"forksCount":62,"repositoryHtmlUrl":63,"repositoryHomepageUrl":64,"ownerHtmlUrl":65,"ownerBlogUrl":66,"ownerDescription":67,"updatedAt":68,"install":69,"resources":82},"01M6MHZFWS7V6QCHTKDN8NGMCR","serving-the-api",null,"Use when the user wants a long-running HTTP service for scrape\u002Fcrawl\u002Fmap instead of one-shot CLI calls or the MCP server — for example wiring crawlberg into other apps over REST. Covers `crawlberg serve`, the Firecrawl-v1-compatible endpoints, `--host`\u002F`--port`, and when to prefer it.","hashgraph-online\u002Fawesome-codex-plugins","hashgraph-online","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F160371962?v=4","01M6CNB6NRJVNNGN14TR01Q6D3","HOL (Hashgraph Online)","01M6JT1HSKKG9V68KQAQGBA7XP",1575,"Apache-2.0","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fkreuzberg-dev\u002Fplugins\u002Fplugins\u002Fcrawlberg\u002Fskills\u002Fserving-the-api\u002FSKILL.md",[18,23,26],{"categoryNo":19,"categoryName":20,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000010","后端与接口","SCENARIO","使用场景",{"categoryNo":24,"categoryName":25,"taxonomyType":21,"taxonomyTypeDesc":22},"01JBSEEDCAT000000000000023","Skill与智能体开发",{"categoryNo":27,"categoryName":28,"taxonomyType":29,"taxonomyTypeDesc":30},"01JBSEEDCAT000000000000030","开发工程师","PROFESSION","适用职业",[32,33,34,35,36,37,38,39,40,41,42,43,44,45,46,47,48,49,50,51,52,53],"serving the api","api","serving","apps","running","when","crawlberg","wiring","for","calls","port","long","MCP","host","map","crawl","example","firecrawl","scrape","server","mcp server","cli","2026-11-10 10:12:30",false,"---\nname: serving-the-api\ndescription: >-\n  Use when the user wants a long-running HTTP service for scrape\u002Fcrawl\u002Fmap\n  instead of one-shot CLI calls or the MCP server — for example wiring\n  crawlberg into other apps over REST. Covers `crawlberg serve`, the\n  Firecrawl-v1-compatible endpoints, `--host`\u002F`--port`, and when to prefer it.\n---\n\n\u003C!--\nAI-RULEZ :: GENERATED FILE — DO NOT EDIT\nContent-Hash: blake3:a011fca3e4de3a4e6442e1779c4425d884cafb3369765d37e52d2f01dd8671bb\nSource-Hash: blake3:b5689383a3914da8e3cc6ad3614356ae7f98c90cf99cb1b4b47be38456ff7a7c\nSchema-Version: v1\n-->\n\n# Serving the API\n\n`crawlberg serve` starts a long-running REST API server exposing the crawl\nengine over HTTP. The endpoints are Firecrawl v1-compatible, so existing\nFirecrawl clients and SDKs can point at a local crawlberg instance.\n\nThis subcommand requires the binary to be built with the optional `api`\nfeature (non-default). The Homebrew tap is built with all features, so `serve`\nis available there; a from-source build needs\n`cargo install crawlberg-cli --features api`\n(or `--features all`) to include it.\n\n## Quick recipe\n\n```bash\ncrawlberg serve --host 127.0.0.1 --port 3000\n```\n\nIt logs `Starting REST API server on \u003Chost>:\u003Cport>` to stderr and blocks until\nterminated. Hit `GET \u002Fhealth` to confirm it is up.\n\n## Flags\n\n| Flag     | Default   | Purpose                          |\n| -------- | --------- | -------------------------------- |\n| `--host` | `0.0.0.0` | Address to bind to.              |\n| `--port` | `3000`    | Port to listen on.               |\n\n`serve` does not take the per-request crawl flags — it boots with the default\n`CrawlConfig` and accepts per-request options in each HTTP request body.\n\n## Endpoints\n\nFirecrawl v1 surface:\n\n| Method + path             | Purpose                                              |\n| ------------------------- | ---------------------------------------------------- |\n| `POST \u002Fv1\u002Fscrape`         | Scrape a single URL (synchronous).                   |\n| `POST \u002Fv1\u002Fcrawl`          | Start an asynchronous crawl job → returns a job `id`. |\n| `GET \u002Fv1\u002Fcrawl\u002F{id}`      | Poll crawl job status and collect results.           |\n| `DELETE \u002Fv1\u002Fcrawl\u002F{id}`   | Cancel a running crawl job.                          |\n| `POST \u002Fv1\u002Fmap`            | Discover URLs on a site (synchronous).               |\n| `POST \u002Fv1\u002Fbatch\u002Fscrape`   | Start an asynchronous batch-scrape job → job `id`.   |\n| `GET \u002Fv1\u002Fbatch\u002Fscrape\u002F{id}` | Poll batch-scrape job status and results.          |\n| `POST \u002Fv1\u002Fdownload`       | Download a document from a URL.                      |\n\nOperational:\n\n| Method + path     | Purpose                                  |\n| ----------------- | ---------------------------------------- |\n| `GET \u002Fhealth`     | Health check (`{ status, version }`).    |\n| `GET \u002Fversion`    | Version information.                     |\n| `GET \u002Fopenapi.json` | OpenAPI schema for the whole surface.  |\n\nRequest bodies use `camelCase` fields. Scrape\u002Fcrawl\u002Fmap mirror the CLI:\n`url`, `formats`, `onlyMainContent`, `includeTags`\u002F`excludeTags`, `timeout`\nfor scrape; `url`, `maxDepth`, `maxPages`, `includePaths`\u002F`excludePaths` for\ncrawl; `url`, `limit`, `search` for map. Responses wrap data as\n`{ success, data | error }`; async jobs return `{ success, id }` and are polled\nfor `{ status, total, completed, data, error }`.\n\n## Examples\n\n### Scrape via HTTP\n\n```bash\ncurl -s http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fscrape \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"url\":\"https:\u002F\u002Fexample.com\",\"formats\":[\"markdown\"]}' | jq '.data'\n```\n\n### Start a crawl job and poll it\n\n```bash\nid=$(curl -s http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fcrawl \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"url\":\"https:\u002F\u002Fexample.com\",\"maxDepth\":2,\"maxPages\":100}' | jq -r '.id')\n\ncurl -s \"http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fcrawl\u002F$id\" | jq '{status,completed,total}'\n```\n\n### Map URLs\n\n```bash\ncurl -s http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fmap \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"url\":\"https:\u002F\u002Fexample.com\",\"limit\":500,\"search\":\"docs\"}' | jq '.data'\n```\n\n## Operational notes\n\n- The server accepts CORS from any origin and ships **no built-in\n  authentication** — do not expose it on a public interface. Bind to\n  `127.0.0.1` for local use, or put it behind a reverse proxy \u002F gateway that\n  enforces auth and rate limiting before exposing it more widely.\n- Request bodies are capped at 10 MB and each request times out after 5\n  minutes.\n- Crawl and batch-scrape are asynchronous: the POST returns a job `id`\n  immediately and you poll the `{id}` endpoint until `status` is `completed`,\n  `failed`, or `cancelled`.\n\n## When to run serve vs. CLI vs. MCP\n\n- **CLI** (`scrape`\u002F`crawl`\u002F`map`\u002F`interact`) — one-shot jobs, shell pipelines,\n  scripting. No long-running process.\n- **MCP** (`crawlberg mcp`) — driving the crawler from an AI agent harness\n  (Claude Code, Codex, Cursor, Gemini, opencode). Auto-registered by this\n  plugin; prefer it inside an agent.\n- **serve** (`crawlberg serve`) — a persistent HTTP service for other\n  applications or non-agent clients that speak REST, or when you want\n  Firecrawl-v1 compatibility. Choose it when many callers need the crawler\n  over the network rather than one agent or one shell.\n","\u003C!--\nAI-RULEZ :: GENERATED FILE — DO NOT EDIT\nContent-Hash: blake3:a011fca3e4de3a4e6442e1779c4425d884cafb3369765d37e52d2f01dd8671bb\nSource-Hash: blake3:b5689383a3914da8e3cc6ad3614356ae7f98c90cf99cb1b4b47be38456ff7a7c\nSchema-Version: v1\n-->\n\n# Serving the API\n\n`crawlberg serve` starts a long-running REST API server exposing the crawl\nengine over HTTP. The endpoints are Firecrawl v1-compatible, so existing\nFirecrawl clients and SDKs can point at a local crawlberg instance.\n\nThis subcommand requires the binary to be built with the optional `api`\nfeature (non-default). The Homebrew tap is built with all features, so `serve`\nis available there; a from-source build needs\n`cargo install crawlberg-cli --features api`\n(or `--features all`) to include it.\n\n## Quick recipe\n\n```bash\ncrawlberg serve --host 127.0.0.1 --port 3000\n```\n\nIt logs `Starting REST API server on \u003Chost>:\u003Cport>` to stderr and blocks until\nterminated. Hit `GET \u002Fhealth` to confirm it is up.\n\n## Flags\n\n| Flag     | Default   | Purpose                          |\n| -------- | --------- | -------------------------------- |\n| `--host` | `0.0.0.0` | Address to bind to.              |\n| `--port` | `3000`    | Port to listen on.               |\n\n`serve` does not take the per-request crawl flags — it boots with the default\n`CrawlConfig` and accepts per-request options in each HTTP request body.\n\n## Endpoints\n\nFirecrawl v1 surface:\n\n| Method + path             | Purpose                                              |\n| ------------------------- | ---------------------------------------------------- |\n| `POST \u002Fv1\u002Fscrape`         | Scrape a single URL (synchronous).                   |\n| `POST \u002Fv1\u002Fcrawl`          | Start an asynchronous crawl job → returns a job `id`. |\n| `GET \u002Fv1\u002Fcrawl\u002F{id}`      | Poll crawl job status and collect results.           |\n| `DELETE \u002Fv1\u002Fcrawl\u002F{id}`   | Cancel a running crawl job.                          |\n| `POST \u002Fv1\u002Fmap`            | Discover URLs on a site (synchronous).               |\n| `POST \u002Fv1\u002Fbatch\u002Fscrape`   | Start an asynchronous batch-scrape job → job `id`.   |\n| `GET \u002Fv1\u002Fbatch\u002Fscrape\u002F{id}` | Poll batch-scrape job status and results.          |\n| `POST \u002Fv1\u002Fdownload`       | Download a document from a URL.                      |\n\nOperational:\n\n| Method + path     | Purpose                                  |\n| ----------------- | ---------------------------------------- |\n| `GET \u002Fhealth`     | Health check (`{ status, version }`).    |\n| `GET \u002Fversion`    | Version information.                     |\n| `GET \u002Fopenapi.json` | OpenAPI schema for the whole surface.  |\n\nRequest bodies use `camelCase` fields. Scrape\u002Fcrawl\u002Fmap mirror the CLI:\n`url`, `formats`, `onlyMainContent`, `includeTags`\u002F`excludeTags`, `timeout`\nfor scrape; `url`, `maxDepth`, `maxPages`, `includePaths`\u002F`excludePaths` for\ncrawl; `url`, `limit`, `search` for map. Responses wrap data as\n`{ success, data | error }`; async jobs return `{ success, id }` and are polled\nfor `{ status, total, completed, data, error }`.\n\n## Examples\n\n### Scrape via HTTP\n\n```bash\ncurl -s http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fscrape \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"url\":\"https:\u002F\u002Fexample.com\",\"formats\":[\"markdown\"]}' | jq '.data'\n```\n\n### Start a crawl job and poll it\n\n```bash\nid=$(curl -s http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fcrawl \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"url\":\"https:\u002F\u002Fexample.com\",\"maxDepth\":2,\"maxPages\":100}' | jq -r '.id')\n\ncurl -s \"http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fcrawl\u002F$id\" | jq '{status,completed,total}'\n```\n\n### Map URLs\n\n```bash\ncurl -s http:\u002F\u002F127.0.0.1:3000\u002Fv1\u002Fmap \\\n  -H 'content-type: application\u002Fjson' \\\n  -d '{\"url\":\"https:\u002F\u002Fexample.com\",\"limit\":500,\"search\":\"docs\"}' | jq '.data'\n```\n\n## Operational notes\n\n- The server accepts CORS from any origin and ships **no built-in\n  authentication** — do not expose it on a public interface. Bind to\n  `127.0.0.1` for local use, or put it behind a reverse proxy \u002F gateway that\n  enforces auth and rate limiting before exposing it more widely.\n- Request bodies are capped at 10 MB and each request times out after 5\n  minutes.\n- Crawl and batch-scrape are asynchronous: the POST returns a job `id`\n  immediately and you poll the `{id}` endpoint until `status` is `completed`,\n  `failed`, or `cancelled`.\n\n## When to run serve vs. CLI vs. MCP\n\n- **CLI** (`scrape`\u002F`crawl`\u002F`map`\u002F`interact`) — one-shot jobs, shell pipelines,\n  scripting. No long-running process.\n- **MCP** (`crawlberg mcp`) — driving the crawler from an AI agent harness\n  (Claude Code, Codex, Cursor, Gemini, opencode). Auto-registered by this\n  plugin; prefer it inside an agent.\n- **serve** (`crawlberg serve`) — a persistent HTTP service for other\n  applications or non-agent clients that speak REST, or when you want\n  Firecrawl-v1 compatibility. Choose it when many callers need the crawler\n  over the network rather than one agent or one shell.\n",{"name":5,"description":7},"main","2b63f856ce19c2a797929cacabd9e0fc936812fa","plugins\u002Fkreuzberg-dev\u002Fplugins\u002Fplugins\u002Fcrawlberg\u002Fskills\u002Fserving-the-api",491,"https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins","https:\u002F\u002Fhol.org\u002Fplugins\u002Fbest-codex-plugins","https:\u002F\u002Fgithub.com\u002Fhashgraph-online","https:\u002F\u002Fhol.org","Open-source standards and developer tools for interoperable AI agents: discovery, identity, communication, payments, privacy and security.","2026-11-14 14:06:13",{"source":8,"skillName":5,"commands":70,"prompt":80,"zipAvailable":81},[71,74,77],{"tool":72,"command":73},"npx","npx skills add hashgraph-online\u002Fawesome-codex-plugins --skill serving-the-api",{"tool":75,"command":76},"bunx","bunx skills add hashgraph-online\u002Fawesome-codex-plugins --skill serving-the-api",{"tool":78,"command":79},"pnpm","pnpm dlx skills add hashgraph-online\u002Fawesome-codex-plugins --skill serving-the-api","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fkreuzberg-dev\u002Fplugins\u002Fplugins\u002Fcrawlberg\u002Fskills\u002Fserving-the-api\u002FSKILL.md",true,[],[84,94,102,110,118,126],{"skillNo":85,"name":86,"nameZh":6,"description":87,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":89,"sourceHtmlUrl":90,"categories":91,"keywords":92,"publishedAt":93},"01M7DV332YQMGD8WTRJ9DZQXTB","worktable-review-with-annotations","Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.","MIT","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-review-with-annotations\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":95,"name":96,"nameZh":6,"description":97,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":98,"sourceHtmlUrl":99,"categories":100,"keywords":101,"publishedAt":93},"01M7DV2YGHCZVBEB1AHYB6CGHE","worktable-find-and-synthesize-context","Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-find-and-synthesize-context\u002FSKILL.md",[],[],{"skillNo":103,"name":104,"nameZh":6,"description":105,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":106,"sourceHtmlUrl":107,"categories":108,"keywords":109,"publishedAt":93},"01M7DV2TQN1H11ME2SAF9MXN7V","worktable-create-or-update-docs","Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-update-docs\u002FSKILL.md",[],[],{"skillNo":111,"name":112,"nameZh":6,"description":113,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":114,"sourceHtmlUrl":115,"categories":116,"keywords":117,"publishedAt":93},"01M7DV2NE452NEA8TXATKSNAJH","worktable-create-or-manage-records","Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-records\u002FSKILL.md",[],[],{"skillNo":119,"name":120,"nameZh":6,"description":121,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":122,"sourceHtmlUrl":123,"categories":124,"keywords":125,"publishedAt":93},"01M7DV2HENRBR2KSCVM064WH0Y","worktable-create-or-manage-interactive-html","Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-create-or-manage-interactive-html\u002FSKILL.md",[],[],{"skillNo":127,"name":128,"nameZh":6,"description":129,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":88,"licenseFileUrl":130,"sourceHtmlUrl":131,"categories":132,"keywords":133,"publishedAt":93},"01M7DV2CADR5R7RQFFYPNAGR9Y","worktable-collaborate-threads","Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FLICENSE","https:\u002F\u002Fgithub.com\u002Fhashgraph-online\u002Fawesome-codex-plugins\u002Fblob\u002Fmain\u002Fplugins\u002Fworktable\u002Fworktable-plugin\u002Fskills\u002Fworktable-collaborate-threads\u002FSKILL.md",[],[]]