Skip to content

sergebulaev/tiktok-skills / .codex-marketplace/tiktok-skills

tiktok-marketing

Verified

Plan, script, caption, and publish short-form video for TikTok. Use when the user wants to write the first 1-3 second hook (spoken line plus on-screen text), draft a caption under 2,200 chars with TikTok settings and hashtags, ride a trending sound without being cringe, strip AI tells from a spoken script to sound human on camera, or plan a week around completion rate. TikTok is video-only: the user supplies the video, the skills produce the script, caption, and settings, then publish via Publora.

lib/url_parser.py

View on GitHub
"""TikTok URL parser.

Handles the common shapes for TikTok videos and profiles:

1. Canonical video URL (from "Copy link" on web):
   https://www.tiktok.com/@HANDLE/video/VIDEO_ID
   ...with optional query params (?is_from_webapp=1&...).

2. Short share URLs (from the in-app "Copy link"):
   https://vm.tiktok.com/ZMabcdef/        (mobile share)
   https://www.tiktok.com/t/ZTabcdef/     (web short)
   These redirect to the canonical URL; we cannot resolve the VIDEO_ID without a
   network request, so we return url_type "short" and the short code.

3. Profile URL:
   https://www.tiktok.com/@HANDLE

4. Bare numeric video ID.

Returns a normalized dict:
    {
      "handle": "<username without @>" | None,
      "video_id": "<numeric>" | None,
      "short_code": "<ZM.../ZT...>" | None,
      "url_type": "video" | "profile" | "short" | "unknown",
      "canonical_url": "https://www.tiktok.com/..." | None,
    }

Note: a TikTok handle keeps its `@` on the platform but the parser strips it in
the `handle` field. Short links must be opened (HTTP redirect) to recover the
numeric video id; this parser does not make network calls.
"""
from __future__ import annotations
import re
from typing import Optional, TypedDict


class ParsedTikTokUrl(TypedDict, total=False):
    handle: Optional[str]
    video_id: Optional[str]
    short_code: Optional[str]
    url_type: str
    canonical_url: Optional[str]


# /@HANDLE/video/VIDEO_ID
_VIDEO_RE = re.compile(
    r"(?:https?://)?(?:www\.|m\.)?tiktok\.com/"
    r"@(?P<handle>[A-Za-z0-9_.]{1,24})"
    r"/video/(?P<id>\d{6,25})",
    re.IGNORECASE,
)
# Short share links: vm.tiktok.com/CODE  or  www.tiktok.com/t/CODE
_SHORT_RE = re.compile(
    r"(?:https?://)?(?:vm|vt)\.tiktok\.com/(?P<code>[A-Za-z0-9]{5,20})"
    r"|(?:https?://)?(?:www\.)?tiktok\.com/t/(?P<code2>[A-Za-z0-9]{5,20})",
    re.IGNORECASE,
)
# Profile: /@HANDLE  (no /video)
_PROFILE_RE = re.compile(
    r"(?:https?://)?(?:www\.|m\.)?tiktok\.com/"
    r"@(?P<handle>[A-Za-z0-9_.]{1,24})/?(?:\?.*)?$",
    re.IGNORECASE,
)


def parse_tiktok_url(url: str) -> ParsedTikTokUrl:
    """Parse any TikTok video, profile, or short-share URL into structured fields.

    >>> p = parse_tiktok_url("https://www.tiktok.com/@levelsio/video/7300000000000000000")
    >>> p["handle"]
    'levelsio'
    >>> p["video_id"]
    '7300000000000000000'
    >>> p["url_type"]
    'video'
    """
    out: ParsedTikTokUrl = {
        "handle": None,
        "video_id": None,
        "short_code": None,
        "url_type": "unknown",
        "canonical_url": None,
    }
    if not url:
        return out

    text = url.strip()

    m = _VIDEO_RE.search(text)
    if m:
        handle = m.group("handle")
        video_id = m.group("id")
        out["handle"] = handle
        out["video_id"] = video_id
        out["url_type"] = "video"
        out["canonical_url"] = f"https://www.tiktok.com/@{handle}/video/{video_id}"
        return out

    m = _SHORT_RE.search(text)
    if m:
        code = m.group("code") or m.group("code2")
        out["short_code"] = code
        out["url_type"] = "short"
        out["canonical_url"] = text.split("?")[0]
        return out

    m = _PROFILE_RE.search(text)
    if m:
        handle = m.group("handle")
        out["handle"] = handle
        out["url_type"] = "profile"
        out["canonical_url"] = f"https://www.tiktok.com/@{handle}"
        return out

    # Bare numeric video id with no host.
    if re.fullmatch(r"\d{6,25}", text):
        out["video_id"] = text
        out["url_type"] = "video"
        out["canonical_url"] = f"https://www.tiktok.com/@i/video/{text}"
        return out

    return out


def build_video_url(handle: str, video_id: str) -> str:
    """Format a canonical tiktok.com video URL from a handle and video id."""
    handle = handle.lstrip("@")
    return f"https://www.tiktok.com/@{handle}/video/{video_id}"


if __name__ == "__main__":
    import json
    import sys

    examples = sys.argv[1:] or [
        "https://www.tiktok.com/@levelsio/video/7300000000000000000?is_from_webapp=1",
        "https://vm.tiktok.com/ZMabcdef12/",
        "https://www.tiktok.com/t/ZTxyz98765/",
        "https://www.tiktok.com/@nasa",
    ]
    for u in examples:
        print(u)
        print(json.dumps(parse_tiktok_url(u), indent=2))
        print()
reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 323kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 323kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 323kUpdated Claude CodeCodexVerifiedInstall