Skip to content
Back to search

hookboard

Plan a week of Reels in a minute: Claude API with structured outputs, an MCP server, Supabase auth, React.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/hari007sh--hookboard/badge.svg)](/listings/hari007sh--hookboard)

HTML

<a href="/listings/hari007sh--hookboard"><img src="/api/listings/hari007sh--hookboard/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 66 lines
  1. # Hookboard
  2. **Plan a week of Reels in about a minute.** → [hookboard.net](https://hookboard.net)
  3. Hookboard plans 3–14 days of short-form posts for a creator or small business. Every post comes with a
  4. 0–1.5 s on-screen hook, the shot behind it, a payoff, a caption, 5–10 targeted hashtags, a shot list and a
  5. pre-posting checklist. It also writes hook variants and critiques captions.
  6. One typed core, three ways to use it:
  7. | Surface | Entry point | For |
  8. |---|---|---|
  9. | Web app (React 19, Tailwind) | `web/` | creators |
  10. | JSON HTTP API (Express) | `src/server/` | other apps and automations |
  11. | **MCP server** (stdio) | `src/mcp/` | Claude Desktop, Claude Code, any MCP client |
  12. ## How it works
  13. ```
  14. web app ──HTTP──▶ Express API ──┐
  15. ├──▶ core planner ──▶ Claude (Anthropic API, structured outputs)
  16. Claude Desktop ──MCP (stdio)────┘
  17. ```
  18. - **Typed end to end:** zod schemas validate every input (web, HTTP and MCP) and define the model's output
  19. format through Claude structured outputs, so every response parses into the expected shape.
  20. - **Model:** Claude Opus 5.5 by default (`HOOKBOARD_MODEL` to change). The system prompt is prompt-cached,
  21. and refusals fall back to another model on the server side.
  22. - **Quality rules in the prompt:** hooks are on-screen words (≤12 words) with the visual described separately,
  23. and the model never invents facts about the creator. Missing details become `[placeholders]`.
  24. - **Accounts:** Supabase Auth (Google Identity Services button + email sign-in links). Saved plans live in
  25. Postgres with row-level security, so users can read and delete only their own rows.
  26. - **Cost control:** signed-in users and anonymous visitors get separate hourly limits, keyed on the real
  27. client IP behind Cloudflare. Users can also bring their own Anthropic key (sent per request, never stored).
  28. - **Embeddable widget:** `<script src="https://hookboard.net/widget.js" data-niche="home baking" async></script>`
  29. renders a hook generator in an auto-resizing iframe on any site.
  30. ## Use it from Claude (MCP)
  31. ```bash
  32. claude mcp add hookboard -- npx tsx /path/to/hookboard/src/mcp/index.ts
  33. ```
  34. Tools: `plan_week`, `write_hooks`, `critique_caption`. Then ask: *"Plan 5 days of posts for my pottery studio."*
  35. ## Run locally
  36. ```bash
  37. npm install && (cd web && npm install && npm run build)
  38. cp .env.example .env # add ANTHROPIC_API_KEY (+ Supabase values for accounts)
  39. npm run server # http://localhost:8790; demo mode with sample output when no key is set
  40. ```
  41. Without credentials everything still works in demo mode, which is handy for UI work and tests.
  42. ## Tests
  43. ```bash
  44. npm test # core planner, HTTP API (limits, auth, errors), MCP server via an in-memory MCP client
  45. npm run typecheck
  46. ```
  47. ## Deploy
  48. `Dockerfile` + `deploy/docker-compose.yml` run the app behind a Cloudflare Tunnel connector (no inbound ports).
  49. Database schema: `supabase/migrations/`. Auth URLs and providers: `supabase/config.toml`.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.