AGENT SKILLBY HYPERFX-AI
TikTok
AT A GLANCE
TikTok is a social media skill for AI agents. End-to-end skill for publishing organic content to TikTok through the TikTok Content Sharing Guidelines-compliant interactive posting form. It is published by hyperfx-ai in the hyperfx-ai/marketing-skills GitHub repository (45 stars) under the MIT license. Install it with: npx skills add hyperfx-ai/marketing-skills --skill tiktok
- SOURCE REPOSITORY
- hyperfx-ai/marketing-skills (opens GitHub in a new tab)
- REPO STARS
- SOURCE REPOSITORY
- LICENSE
- MIT
- CATEGORIES
- SKILL.MD SIZE
- 5.9 KB143 LINES
QUICK ANSWER
- WHAT IT IS01
- End-to-end skill for publishing organic content to TikTok through the TikTok Content Sharing Guidelines-compliant interactive posting form. It stands out by giving social content a defined shape, so the agent asks for better context and returns a more usable result.
- INPUTS02
- Context for social content: your goals, audience, constraints, and any source material the skill asks for.
- OUTPUT03
- A ready-to-use result for social content: the analysis, copy, or recommendations the agent produces.
INSTALL
One command adds this skill from its source repository.
npx skills add hyperfx-ai/marketing-skills --skill tiktokREAD THE SKILL.MD BELOW BEFORE YOU RUN IT. SKILLS INSTRUCT YOUR AGENT.
SKILL.MD
The full file, as published in the source repository. Copy it, download it or open it on GitHub.
ON THIS PAGE · 11
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 (opens in a new tab)
- TikTok integration connected at https://app.hyperfx.ai/apps (opens in a new tab) — 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_formwhen a user wants to post to TikTok. NEVER calltiktok_post_video_from_url,tiktok_post_photos, ortiktok_post_video_from_filedirectly 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_formimmediately 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:
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_urlortiktok_post_photosdirectly.
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 (
#hashtagsand@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.
Pre-fill Parameters#
When calling tiktok_open_post_form, provide what you know:
| Parameter | When to provide |
|---|---|
media_type | Always ("video" or "photo"). |
media_url | Single video or single photo. |
media_urls | Photo carousel (list of URLs, max 35). |
video_duration_sec | If known — enables duration validation. |
title | If the user mentioned a caption. |
is_aigc | If you generated the media (Sora, Veo, image gen, etc.). |
After Form Submission#
When the user fills out and submits the form, you receive a message containing all their chosen settings. At that point, call the appropriate posting tool with the exact parameters from their submission:
- Video from URL:
tiktok_post_video_from_url - Video from file:
tiktok_post_video_from_file - Photos:
tiktok_post_photos
The posting tool will automatically poll status and return a completion message.
Media Format Requirements#
Videos:
- Format: MP4 + H.264 recommended.
- Resolution: 720p minimum, 4K maximum.
- Aspect ratio: 9:16, 16:9, or 1:1.
- Duration: 3s minimum, max varies by account (checked by the form).
Photos:
- Format: WebP or JPEG only (PNG is NOT supported).
- Resolution: 1080p maximum.
- Size: 20MB per photo maximum.
- Carousel: up to 35 photos.
Domain verification:
- All media URLs must be from verified domains in the TikTok Developer Portal.
- Unverified domains will fail with an authentication error.
Example Flow#
- User: "Post this video to TikTok".
- You: call
tiktok_open_post_form(media_type="video", media_url="<url>"). - The posting form opens in the artifact panel.
- User configures privacy, caption, policies, etc.
- User clicks "Post to TikTok".
- You receive their settings as a message.
- You: call
tiktok_post_video_from_url(...)with the submitted parameters. - Tool auto-polls and returns status (complete, failed, or timeout).
Inbox / Draft Path (no form required)#
These tools intentionally bypass the form — they send content to the user's TikTok app for manual posting:
tiktok_upload_video_from_url— send video to inbox as draft.tiktok_upload_video_from_file— upload file to inbox as draft.tiktok_upload_photos— send photos to inbox as draft.
Use these only when the user explicitly asks to "send to my TikTok drafts" or "I want to post manually in the app". Otherwise, default to the form path.
FAQ
07 QUESTIONS
01What is the TikTok agent skill?
End-to-end skill for publishing organic content to TikTok through the TikTok Content Sharing Guidelines-compliant interactive posting form. It is listed under social media in the 100xLab agent skills directory.
02How do I install TikTok in Cursor, Claude Code, or Codex?
Run npx skills add hyperfx-ai/marketing-skills --skill tiktok in the project where you want it, then ask your agent for the skill by name. The --skill flag installs only TikTok, not every skill in the repository.
03What does the TikTok SKILL.md cover?
The SKILL.md includes sections on Out of scope — defer to other skills, Requirements, Tool surface, Critical Rules, When the User Wants to Post and What the Form Handles. Read the full text on this page or in plain markdown at /resources/agent-skills/hyperfx-ai-marketing-skills--tiktok--1qlxowq/raw.
04Which agents can use TikTok?
TikTok installs with the cross-agent skills installer (npx skills add), which sets it up for agents such as Claude Code, Cursor and Codex. Each agent loads the SKILL.md when you ask for the skill by name.
05What license is TikTok under?
The hyperfx-ai/marketing-skills repository declares the MIT license. Read the license file in the repository before you copy or redistribute the skill.
06Is TikTok free to use?
Reading, copying and installing TikTok costs nothing: it is published in a public GitHub repository under the MIT license. Reuse and redistribution follow that license.
07Where is the source of TikTok?
TikTok comes from https://github.com/hyperfx-ai/marketing-skills, which has 45 GitHub stars. The SKILL.md is at https://github.com/hyperfx-ai/marketing-skills/blob/HEAD/skills/tiktok/SKILL.md. The author is hyperfx-ai.
Need an agent workflow built around your stack?
Tell us the workflow you want automated. We reply within 4 working hours (IST).
ATTRIBUTION
TikTok was written by its original authors and is published in hyperfx-ai/marketing-skills (opens GitHub in a new tab) under the MIT license. All rights stay with the original authors.
100xLab did not write, maintain or endorse this skill. This page lists it for discovery. Repo stars belong to the source repository, not to the skill. Review any skill before you install it.