{
  "markdown": "# host-html\n\n[![host-html.com](screenshot.png)](https://host-html.com)\n\n> **Publish any HTML file as a live link — instantly.**\n> Free account required. No deploy pipeline, no server to manage.\n> → **[host-html.com](https://host-html.com)**\n\n> **Heads up — breaking change in v2.0.0:** Anonymous publishing has been\n> retired. Publishing now requires a free, email-verified host-html account\n> and a personal API key set as `HOSTHTML_API_KEY`. See\n> [Setup: get an API key](#setup-get-an-api-key). Older releases that relied\n> on the built-in shared key will stop publishing.\n\n---\n\n## Install\n\n### Claude Code\n```\n/plugin marketplace add phanosh/host-html\n/plugin install host-html@host-html\n```\n\n> The official Claude Code marketplace listing is in the works — until it lands, install directly from this repo with the two commands above.\n\n### Other AI Agents (Skills)\n```bash\nnpx skills add phanosh/host-html -g -y\n```\n\nThen use the skills:\n\n```\n/host-html          # publish HTML as a live link\n/host-pdf           # export HTML slides to PDF\n```\n\n`/host-html` finds the HTML, publishes it, and hands you a live URL in seconds.\n`/host-pdf` captures each slide at retina quality and assembles a PDF.\n\nWorks with **Claude Code**, Cursor, Codex, Copilot, and [40+ more agents](https://host-html.com).\n\n---\n\n## Setup: get an API key\n\nPublishing now requires a free host-html account:\n\n1. Sign in (free) at [host-html.com](https://host-html.com)\n2. Confirm your email\n3. Go to **Account → API keys → Create key**\n4. Copy the generated key (starts with `hh_…` — shown once)\n5. Set it as an environment variable:\n\n   ```bash\n   export HOSTHTML_API_KEY=hh_your_key_here\n   ```\n\nThe skill reads `HOSTHTML_API_KEY` automatically. Custom slugs (see the Direct\nAPI table below) still require a Pro/Team plan; publishing itself does not.\n\n---\n\n## Update\n\nWhen a new version is released here, pull it into your local Claude Code with:\n\n```\n/plugin marketplace update phanosh/host-html\n```\n\nThat single command refreshes the marketplace catalog and installs any version bumps in `marketplace.json`, `plugin.json`, or the skill frontmatter. To check what you're on:\n\n```\n/plugin\n```\n\nTo stay current automatically, open `/plugin`, go to the **Marketplaces** tab, select `phanosh/host-html`, and toggle **auto-update** on — Claude Code will then pull updates on startup.\n\nFor the standalone skills install (`npx skills add ...`), re-run the same command to upgrade:\n\n```bash\nnpx skills add phanosh/host-html -g -y\n```\n\n---\n\n## Direct API\n\nThe publish edge function requires a personal host-html API key (format\n`hh_…`) as the bearer token — see [Setup](#setup-get-an-api-key) to generate\none. Pass it via the `Authorization` header (no `apikey` header is needed):\n\n```bash\ncurl -X POST https://suifgsvtcbrawzdhyuhk.supabase.co/functions/v1/publish \\\n  -H \"Authorization: Bearer $HOSTHTML_API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"html\": \"<h1>Hello</h1>\", \"title\": \"my page\"}'\n```\n\n**Request**\n\n| Field   | Type   | Required | Description                                  |\n|---------|--------|----------|----------------------------------------------|\n| `html`  | string | ✓        | HTML content (max 1MB)                       |\n| `title` | string |          | Page title                                   |\n| `slug`  | string |          | Custom URL path matching `^[a-z0-9-]{2,64}$` |\n\n**Response `201`**\n\n```json\n{\n  \"url\": \"https://host-html.com/p/abc123\",\n  \"slug\": \"abc123\",\n  \"edit_token\": \"...\",\n  \"page_id\": \"...\",\n  \"expires_at\": \"2026-03-16T...\"\n}\n```\n\n`expires_at` is `string | null`. On a free plan it is the ISO timestamp when the page goes\ndark; on a paid plan the page never expires and the field is `null`. It is the authoritative\nexpiry — read it from the response rather than assuming a fixed duration, and handle the null\nrather than formatting it as a date.\n\n---\n\n## License\n\nMIT\n",
  "bytes": 3905,
  "sha": "6820d23dd60a722badf1ebac3855119e6633e2eae2bc8606f1022993224289a3",
  "repo_slug": "phanosh/host-html",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_phanosh_host_html_host_html_42470b4f/readme"
}