Skip to content
Back to search

jaz-cloud

MarketplaceWorks with Claude CodeGitHub

Jaz Cloud: let Claude watch TikTok, Instagram Reels and YouTube links (hosted, API key).

Safety scan

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

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/lnc2131--jaz-cloud/badge.svg)](/listings/lnc2131--jaz-cloud)

HTML

<a href="/listings/lnc2131--jaz-cloud"><img src="/api/listings/lnc2131--jaz-cloud/badge.svg" alt="findsafeskills safety rating" /></a>

Install

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.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "jaz-cloud",
  3. "description": "Jaz Cloud: let Claude watch TikTok, Instagram Reels and YouTube links (hosted, API key).",
  4. "owner": {
  5. "name": "Lucas Chen"
  6. },
  7. "plugins": [
  8. {
  9. "name": "jaz-cloud",
  10. "source": "./plugins/jaz-cloud",
  11. "description": "Watch video links: voiceover transcript, on-screen text and caption."
  12. }
  13. ]
  14. }
README.md · README · 115 lines
  1. # Jaz Cloud
  2. > **Status: personal self-hosting.** Right now this runs on my own always-on Mac so I can use
  3. > Jaz from my phone ([SELF-HOST.md](SELF-HOST.md)). It's also the template for a possible paid,
  4. > hosted version later: the server, API keys, daily limits and plugin work today; billing and
  5. > cloud deployment aren't built. For the free version that runs on your own computer, use
  6. > [Jaz](https://github.com/lnc2131/jaz-videowatching-skill).
  7. A hosted MCP server that lets AI agents "watch" video links. Send it an Instagram,
  8. TikTok, YouTube, Pinterest, X or Facebook link (or any web page) and it returns the
  9. caption, the voiceover transcript with timestamps, and the text shown on screen.
  10. ## Repo layout
  11. | Path | What it is |
  12. |---|---|
  13. | `src/jaz_cloud/` | The server: pipeline, API keys, jobs, signed download links |
  14. | `plugins/jaz-cloud/` | Claude Code plugin customers install: skill + `.mcp.json` pointing at your server |
  15. | `skills/jaz/` | The same skill on its own, for skills directories |
  16. | `.claude-plugin/marketplace.json` | Lets customers run `claude plugin marketplace add lnc2131/jaz-cloud` |
  17. | `Dockerfile` | Draft container for deployment (untested) |
  18. ## Customer install (once deployed)
  19. ```bash
  20. claude plugin marketplace add lnc2131/jaz-cloud
  21. claude plugin install jaz-cloud@jaz-cloud
  22. ```
  23. Claude Code asks for the API key (`jaz_...`) during install. Before publishing, replace
  24. `https://YOUR-DOMAIN/mcp` in `plugins/jaz-cloud/.mcp.json` with your server's address.
  25. ```
  26. link ─► yt-dlp download ─► ffmpeg ─┬─► faster-whisper ─► transcript
  27. └─► frames every 1.5s ─► RapidOCR ─► on-screen text (deduped)
  28. ```
  29. Agents call two MCP tools:
  30. | Tool | What it does |
  31. |---|---|
  32. | `parse_video(url)` | Starts (or reuses) a job and waits up to 25s. Returns the extract, or a `job_id` if it's still processing. |
  33. | `get_result(job_id)` | Waits up to 25s more for a job and returns the extract. |
  34. The agent builds recipes, place lists and so on from the extract (see
  35. `plugins/jaz-cloud/skills/jaz/SKILL.md`), so the server needs no LLM API key.
  36. ## Run it locally
  37. ```bash
  38. uv sync
  39. uv run jaz-cloud keys create --label me --plan video # prints the key once
  40. uv run jaz-cloud serve # http://127.0.0.1:8765/mcp
  41. ```
  42. Try it without a client:
  43. ```bash
  44. uv run jaz-cloud extract "https://youtu.be/jNQXAC9IVRw"
  45. uv run python tests/smoke.py <api-key> "https://youtu.be/jNQXAC9IVRw"
  46. uv run pytest -q
  47. ```
  48. Connect Claude Code to the local server:
  49. ```bash
  50. claude mcp add --transport http jaz-cloud http://127.0.0.1:8765/mcp --header "Authorization: Bearer <api-key>"
  51. ```
  52. ## Accounts and limits
  53. - API keys are stored as SHA-256 hashes. `keys create | list | revoke <prefix>`.
  54. - Plans: `extract` (30 new links/day) and `video` (60/day, plus signed download links
  55. for the original files that last 21 days).
  56. - The same link (any share-link variant for YouTube) on the same UTC day is free for
  57. a key that already asked for it, and reuses the finished job across keys.
  58. - Failed jobs don't count toward the limit.
  59. ## Settings (environment variables)
  60. | Variable | Default | Notes |
  61. |---|---|---|
  62. | `JAZ_DATA_DIR` | `./data` | SQLite DB, media, secret key |
  63. | `JAZ_HOST` / `JAZ_PORT` | `127.0.0.1` / `8765` | |
  64. | `JAZ_PUBLIC_BASE_URL` | `http://127.0.0.1:<port>` | Used in download links and allowed Host headers |
  65. | `JAZ_WHISPER_MODEL` | `large-v3-turbo` | Any faster-whisper model name |
  66. | `JAZ_WHISPER_DEVICE` | `mps` on Apple Silicon, else `auto` | `cuda` on a GPU server |
  67. | `JAZ_WORKERS` | `2` | Parallel jobs |
  68. | `JAZ_MAX_DURATION_S` | `3600` | Longer videos are refused |
  69. | `JAZ_DAILY_LIMIT_EXTRACT` / `_VIDEO` | `30` / `60` | |
  70. | `JAZ_COOKIES_FILE` | none | Netscape cookies file for platforms that demand a login |
  71. | `JAZ_SECRET` | generated | Signs download links |
  72. ## Security
  73. - `/mcp` needs `Authorization: Bearer <key>`; everything else is public (`/healthz`,
  74. signed `/files/...` links).
  75. - Links that resolve to private, loopback or cloud-metadata addresses are refused
  76. (SSRF). Known gap: DNS rebinding between the check and the fetch.
  77. ## Known limits
  78. - **Platform blocking is the main risk of hosting.** Instagram, TikTok and YouTube
  79. often block or demand logins from datacenter IPs. Works from a home connection;
  80. on a server you'll likely need `JAZ_COOKIES_FILE` and/or residential proxies.
  81. Check each platform's terms before offering this commercially.
  82. - Instagram/TikTok photo-only posts depend on yt-dlp support and may fail.
  83. - Transcripts and OCR are machine output and can contain mistakes.
  84. - No billing yet: keys are created by hand.
  85. ## Roadmap
  86. 1. Billing: Stripe Checkout + webhook that creates/revokes keys per subscription.
  87. 2. Deploy: Dockerfile is a draft; host on a GPU box (or CPU with `JAZ_WHISPER_MODEL=small`).
  88. 3. Optional server-side structured extract (recipes, places) with an LLM.

Ratings and comments

Sign in to rate this skill.

Sign in

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