MCPInstall

tiktok-music-archive-downloader

by postplusaiMedia & Creative

Download TikTok video samples for selected music or sounds, extract local audio references, and preserve manifests for reproducible music research archives.

Installs
499
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/postplusai/postplus-skills --skill tiktok-music-archive-downloader
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads tiktok-music-archive-downloader automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

TikTok Music Archive Downloader

Use this skill after TikTok music or sound candidates have already been selected and the user needs local sample files, audio references, and a reproducible archive manifest.

Apply shared local-dependency and user-guidance rules from postplus-shared.

Do Not Use When

  • The user is still discovering trending music. Start with tiktok-research.
  • The user needs hosted TikTok metadata collection.
  • The user asks whether an audio is legally cleared for public posting.

Required Input

  • A small download manifest with TikTok post page URLs.
  • Local dependencies: python3 with yt_dlp, and ffmpeg.
  • A work folder where the archive can be written under .postplus/.

When a normalized upstream dataset includes both postPageUrl and direct video fields, prefer the canonical TikTok post page URL for sourceUrl.

Access Boundary

Downloads are supported only for TikTok post URLs reachable from the user's current local browser/IP environment after dependency checks pass. Local tools are necessary but not sufficient when TikTok gates a post by IP, browser access, login, or cookies.

If the download report contains failureCode: "tiktok_ip_blocked", report the blocker with the preserved sourceUrl, stderr, and report path. Do not retry broad downloads, switch proxies, or invent a cookie/browser bootstrap path.

Default Workflow

  1. Build a bounded manifest from selected videos or sounds.
  2. Run the shared downloader:
  --manifest <download-manifest.json> \
  --output-dir <videos-dir> \
  --report <download-report.json> \
  --concurrency 2 \
  --attempts 3
  1. Stop on download blockers before audio extraction.
  2. Extract audio from successful downloads with ffmpeg.
  3. Write an index.json that links each local file to musicId, musicTitle, sourceVideoUrl, source collection path, download status, local video path, and local audio path.

Archive Layout

Use:

<work-folder>/.postplus/tiktok-music-archive-downloader/<run-id>/
  manifest/
  videos/
  audio/
  index.json

Keep final archive summaries or selected exports outside .postplus/ only when the user needs to inspect or pass them onward.

Verification

  • Confirm downloaded files exist and are non-empty.
  • Confirm audio files exist and are non-empty.
  • Report failures separately instead of hiding them.
  • Keep source URLs in the manifest even when download fails.
  • Do not proceed to audio extraction for a source set blocked by TikTok access.

Rights Posture

Treat downloaded TikTok music as research or reference material unless the user confirms rights or platform-licensed use. Do not present extracted audio as cleared for commercial reuse.

Handoff

  • Need more TikTok music or source candidates -> tiktok-research.
  • Need video-level breakdown -> video-analysis.
  • Need transcription or voice extraction -> audio-transcription or video-transcription.

Public Command Boundary

  • Choose the smallest matching command or workflow from the user input and run it directly.
  • If an owned CLI or script command fails, report the exact error and stop. Do not bypass the failure with metadata-only answers, readiness probing, local payload rewrites, fallback providers, or unpublished tools.
  • Use postplus research schema --collection-key <collection-key> --json only when constructing or repairing an unknown request shape.
  • Hosted collection: postplus research collect --skill tiktok-music-archive-downloader --collection-key <collection-key> --input <hosted-envelope.json> --output <collection-result.json>.
  • Resume a pending collection: postplus research collect --run-handle <runHandle> --output <collection-result.json>.
  • Keep the first pass bounded; expand only after inspecting the first result.
  • If the CLI returns a quote-confirmation challenge, run postplus quote confirm --json --challenge-file <challenge.json> and retry with the returned token.

FAQ

What does the tiktok-music-archive-downloader skill do?

Download TikTok video samples for selected music or sounds, extract local audio references, and preserve manifests for reproducible music research archives.

How do I install tiktok-music-archive-downloader?

Run npx skills add https://github.com/postplusai/postplus-skills --skill tiktok-music-archive-downloader in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tiktok-music-archive-downloader/ (personal) or .claude/skills/tiktok-music-archive-downloader/ (project).

Which AI agents can use tiktok-music-archive-downloader?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is tiktok-music-archive-downloader safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains tiktok-music-archive-downloader?

It is published by postplusai in postplusai/postplus-skills. It has 499 recorded installs.

More from postplusai/postplus-skills

View all →

audio-transcription

postplusai/postplus-skills

Transcribe local or remote audio into text and timestamps. Convert an existing timed transcript locally into SRT or ASS without another transcription job.

Media & Creative1.3K installs

video-transcription

postplusai/postplus-skills

Transcribe speech in local or remote videos with timestamps. Convert existing timed transcripts locally into SRT or ASS; use media-analysis for visual understanding.

Media & Creative1.2K installs

google-trends-research

postplusai/postplus-skills

Research Google Trends keyword momentum, regional interest, and related queries. Use search-interest evidence without treating it as sales or total demand.

Productivity & Automation1.2K installs

facebook-research

postplusai/postplus-skills

Research public Facebook pages, groups, posts, reels, comments, ads, events, marketplace listings, and profiles for audience or competitor evidence.

Productivity & Automation1.1K installs

youtube-research

postplusai/postplus-skills

Research public YouTube channels, video metrics, and comment samples; obtain downloadable video records when requested. Use for content and audience evidence.

Productivity & Automation1.1K installs

video-analysis

postplusai/postplus-skills

Analyze local or remote social videos through PostPlus, especially for TikTok/Reels shot beats, timelines, voiceover or on-screen text capture, creative strategy, and natural Markdown outputs. Use this when you need video-level analysis beyond metadata and want results linked back to source metadata.

Media & Creative1.1K installs

Popular media & creative skills

View category →

hyperframes

heygen-com/hyperframes

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

Media & Creative1.2M installs

media-use

heygen-com/hyperframes

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

Media & Creative1.1M installs

hyperframes-registry

heygen-com/hyperframes

About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.

Media & Creative1M installs

hyperframes-creative

heygen-com/hyperframes

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.

Media & Creative916.5K installs

ai-video-generation

101-skills/superpowers

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Media & Creative881.5K installs

ai-image-generation

101-skills/superpowers

Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image

Media & Creative880.3K installs