`04-tiktok-api-setup.md`

25 lines

# @BHvideoguide — TikTok Content Posting API wiring

Goal: publish videos to @BHvideoguide programmatically (like the DW `tiktok` skill does for Designer Wallcoverings), so the launch plan can run on a schedule instead of manual uploads.

## Reality check on what's gated
The TikTok **Content Posting API** is not instant-on. It requires:
1. A registered app in **TikTok for Developers** (developers.tiktok.com) tied to a business.
2. The **`video.publish`** scope, which TikTok **audits/approves** before you can post to a public account (unaudited apps can only post to the creator's own account in *private/self-only* mode).
3. A one-time **OAuth authorize** where the @BHvideoguide account grants the app access — **only Steve can click this** (login + approve).

So this piece is **Steve-gated by design** — I can prep everything up to the human authorize + TikTok's approval.

## Setup steps
1. **[Claude can draft]** Register the app: name "Beverly Hills Videos", scopes `user.info.basic`, `video.publish`, `video.upload`. Redirect URI → a small callback on Kamatera (mirror the DW tiktok skill's flow) or `https://beverlyhillsvideos.com/tiktok/callback`.
2. **[Steve]** In TikTok for Developers, create/claim the app and submit `video.publish` for audit (needs a demo video of the flow — I can produce that).
3. **[Steve, one-time]** Run the OAuth authorize while logged into @BHvideoguide → grants the app; the callback captures the access + refresh token.
4. **[Claude]** Store tokens via the `secrets` skill (route to a `beverlyhillsvideos` .env + MCP env), mirroring how DW creds are handled.
5. **[Claude]** Wire a `post.py` (upload → publish with caption + hashtags) reusing the DW `tiktok` skill's Content Posting API calls.

## Interim (works today, no API approval needed)
Until the API is audited/approved, run the launch **manually**: I generate the MP4s + write the caption/hashtag block per video (files ready in this repo), Steve uploads from the TikTok app (2 min each). This unblocks the launch immediately while the API approval is pending.

## Note
Reuse the existing DW `tiktok` skill machinery where possible — do NOT stand up a parallel implementation. This account is a *second* posting target, not a new system.