# TikTok Human Guide

## What This Is For
End-to-end skill for publishing organic content to TikTok through the TikTok Content Sharing Guidelines-compliant interactive posting form. It gives the agent a clearer input/output frame for social content: what context to ask for, what decisions to make, and what usable artifact to return.

Use this as a human-readable version of the TikTok agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions.

## When To Use This
- Use this when you need a repeatable process for TikTok.
- Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt.
- Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact.

## When Not To Use This
- Do not use this when you only need a quick factual answer.
- Do not use this when the work depends on private data you cannot share with the assistant.
- Do not use this as a replacement for legal, compliance, financial, or medical review.

## What You Need Before Starting
- The goal or business outcome you want.
- The audience, customer segment, or market context.
- Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance.
- Constraints such as tone, length, channel, deadline, region, or approval requirements.
- A clear definition of what a good final answer should look like.

## Step-By-Step Workflow
1. State the job clearly: "Use the TikTok guide to help me with..."
2. Add context: audience, goal, offer, channel, source material, and constraints.
3. Ask the assistant to identify missing inputs before producing the final output.
4. Have the assistant follow the skill-specific guidance below.
5. Review the result against the final checklist and ask for revisions where needed.

## Skill-Specific Guidance
- **Hyper MCP installed and connected.** [https://app.hyperfx.ai/mcp](https://app.hyperfx.ai/mcp)
- **TikTok integration connected** at [https://app.hyperfx.ai/apps](https://app.hyperfx.ai/apps) — this skill uses the TikTok Login Kit / Content Posting API (NOT the TikTok Marketing API).
- "post this video/photo to TikTok"
- Ask about privacy settings before opening the form.
- Ask about caption / title before opening the form.
- Ask about policy acknowledgments before opening the form.
- Request any metadata — just open the form.
- Call `tiktok_post_video_from_url` or `tiktok_post_photos` directly.
- Creator identity display (username, avatar).
- Media preview (video player or photo grid).
- Caption / title entry with character limits (`#hashtags` and `@mentions`).
- Privacy level selection (filtered to account-eligible options).

## Decision Points And Nuance
The original skill emphasizes: Out of scope — defer to other skills, Requirements, Tool surface, Critical Rules, When the User Wants to Post, What the Form Handles, Pre-fill Parameters, After Form Submission, Media Format Requirements, Example Flow.

Use these questions to steer the work:
- What is the intended audience or buyer?
- What source material must be preserved?
- What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion?
- What examples represent the desired quality bar?
- What should the assistant avoid?

## Common Mistakes
- > **CRITICAL**: Do NOT ask the user about privacy, policies, captions, or branded content settings before opening the form. The form handles all of this interactively.
- > **CRITICAL**: Call `tiktok_open_post_form` immediately when the user wants to post. Do not gather information first.
- All media URLs must be from verified domains in the TikTok Developer Portal.
- Inbox / Draft Path (no form required)

## Copy-And-Paste Prompt
```text
Use the TikTok human guide.

My goal:
[Describe the business outcome]

Audience:
[Describe who this is for]

Context and source material:
[Paste notes, examples, links, or existing copy]

Constraints:
[Tone, length, channel, timeline, must-include items, must-avoid items]

Before producing the final output, ask me for any missing information that would materially improve the result.
```

## Final Checklist
- [ ] The output matches the original goal.
- [ ] The audience and context are reflected in the answer.
- [ ] Important constraints and source material were preserved.
- [ ] The assistant made the relevant decisions explicit.
- [ ] The final artifact is ready to use, review, or hand to the next person.

## Source
This guide was generated from the hyperfx-ai/marketing-skills skill entry for `tiktok`.

## Source Skill Notes
These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic.

# TikTok

End-to-end skill for publishing organic content to TikTok through the **TikTok Content Sharing Guidelines-compliant** interactive posting form.

## Out of scope — defer to other skills

| Request | Send them to |
| --- | --- |
| TikTok ad campaign, Spark Ads, paid promotion | `tiktok-ads` |
| Instagram post / Reel / story | `instagram` |
| LinkedIn document or carousel post | `linkedin` |

## Requirements

- **Hyper MCP installed and connected.** [https://app.hyperfx.ai/mcp](https://app.hyperfx.ai/mcp)
- **TikTok integration connected** at [https://app.hyperfx.ai/apps](https://app.hyperfx.ai/apps) — this skill uses the TikTok Login Kit / Content Posting API (NOT the TikTok Marketing API).

If `tiktok_open_post_form` is not in the tool list, stop and tell the user to enable Hyper MCP and connect TikTok.

## Tool surface

| Tool | Purpose |
| --- | --- |
| `tiktok_open_post_form` | **The only entrypoint when a user wants to post.** Opens the compliance form. |
| `tiktok_post_video_from_url`, `tiktok_post_video_from_file`, `tiktok_post_photos` | Final posting tools — call ONLY after the user submits the form. |
| `tiktok_get_user_info` | Authenticated user profile (does not require the form). |
| `tiktok_query_creator_info` | Check posting capabilities and limits. |
| `tiktok_list_videos`, `tiktok_query_videos` | Browse the user's published videos. |
| `tiktok_get_post_status` | Check the status of a previously submitted post. |
| `tiktok_upload_video_from_url`, `tiktok_upload_video_from_file`, `tiktok_upload_photos` | Send to inbox as draft (user posts manually in the TikTok app — bypasses the form intentionally). |

## Critical Rules

> **CRITICAL**: ALWAYS use `tiktok_open_post_form` when a user wants to post to TikTok. NEVER call `tiktok_post_video_from_url`, `tiktok_post_photos`, or `tiktok_post_video_from_file` directly in response to a user request. The posting form is required for TikTok compliance.

> **CRITICAL**: Do NOT ask the user about privacy, policies, captions, or branded content settings before opening the form. The form handles all of this interactively.

> **CRITICAL**: Call `tiktok_open_post_form` immediately when the user wants to post. Do not gather information first.

## When the User Wants to Post

If the user says ANY of:

- "post this video/photo to TikTok"
- "share this on TikTok"
- "upload to TikTok"
- "put this on my TikTok"

**Immediately call `tiktok_open_post_form`:**

```python
tiktok_open_post_form(
    media_type="video",            # or "photo"
    media_url="<url>",             # single video / single photo URL
    media_urls=["<url>", ...]      # for photo carousels (max 35)
)
```

**DO NOT:**
- Ask about privacy settings before opening the form.
- Ask about caption / title before opening the form.
- Ask about policy acknowledgments before opening the form.
- Request any metadata — just open the form.
- Call `tiktok_post_video_from_url` or `tiktok_post_photos` directly.

## What the Form Handles

The interactive posting form is TikTok Content Sharing Guidelines compliant and handles:

- Creator identity display (username, avatar).
- Media preview (video player or photo grid).
- Caption / title entry with character limits (`#hashtags` and `@mentions`).
- Privacy level selection (filtered to account-eligible options).
- Interaction settings (comments, duet, stitch).
- AI-generated content labeling.
- Commercial content disclosure (branded / promotional).
- Music Usage Confirmation acknowledgment.
- Branded Content Policy acknowledgment.
- Posting restrictions / ban detection.
- Video duration validation.
