tiktok-maxvision

MaxVision TikTok Suite

TikTok + TikTok Shop automation for Claude Code: 28+ MCP tools, OAuth + Apify hybrid backend, Free / Pro / Shop+ / Agency tiers via Stripe.

Status: v0.0.1-alpha — Phase 0 scaffold. Not production-ready. See ROADMAP.

---

What this is

A Claude Code plugin (tiktok-maxvision) that connects to a hosted MCP server (Node 20 + TypeScript + Hono + Drizzle + Postgres + Redis). Targeted at TikTok creators, Shop sellers, and agencies.

Mirrors the architecture of linkedin-maxvision and x-maxvision. Same operator, same backbone, different platform.

Planned surface

Tier	$/mo	Quota	Tools
Free	$0	100 reads/mo	6 Creator tools (public data only)
Pro	$39	2k reads + 200 writes	10 Creator + analytics
Shop+	$79	5k reads + 500 writes	+ 12 Shop Partner + Content Posting
Agency	$199	25k reads + 5k writes	+ 4 multi-tenant + Business API (v0.2)

All paid tiers include 7-day trial.

Roadmap

• Phase 0a — Infra placeholder ✅ Done (CF Worker/KV/Pages, DNS, Stripe products, TikTok Dev Portal apps)
• Phase 0b — Repo + scaffold 🚧 Current
• Phase 1 — Core infra ⏳ DB schema, crypto, auth middleware, token-bucket rate limit, hooks
• Phase 2 — OAuth flows ⏳ Login Kit + Shop Partner v2 (HMAC) + Business
• Phase 3 — Free Creator tools ⏳ 10 tools + Apify adapter + vitest
• Phase 4 — Pro Shop tools ⏳ 12 tools + cache + webhook listener
• Phase 5 — Pro Intel + Posting ⏳ Competitor track + bulk export + Content Posting cron
• Phase 6 — Agency tools ⏳ Multi-tenant pool + white-label
• Phase 7 — Plugin components ⏳ 4 agents + 6 skills + 12 commands + 3 hooks (bilingual EN/PT)
• Phase 8 — License Worker + Stripe webhook ⏳ CF Worker maxv-tiktok-license full implementation
• Phase 9 — Docker swarm VPS deploy + monitoring ⏳
• Phase 10 — n8n workflows + E2E smoke ⏳

Repository layout

maxvision-tiktok-mcp/
├── plugins/tiktok-maxvision/    # Claude Code plugin (public AGPL-3.0)
├── mcp-server/                  # Hono + MCP SDK HTTP server (public AGPL-3.0)
├── workers/license/             # Cloudflare Worker for license validation
├── landing/                     # CF Pages — tiktok.produtoramaxvision.com.br
├── docs/                        # ADRs + architecture docs
└── .github/workflows/           # CI/CD pipelines

Pro/Shop+/Agency tier implementations live in the private companion repo: produtoramaxvision/maxvision-tiktok-mcp-pro (EULA proprietary).

Development

pnpm install
pnpm typecheck
pnpm --filter @maxvision/tiktok-mcp-server dev

Requires Node ≥20 and pnpm ≥9.

License

• Plugin sources + free-tier MCP server: AGPL-3.0 (see LICENSE).
• Pro/Shop+/Agency tools: proprietary, EULA — separate private repo.

Contact

produtoramaxvision@gmail.com · https://produtoramaxvision.com.br