# Send Download-video-tiktok to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "download-video-tiktok",
    "name": "Download-video-tiktok",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/stoxca/download-video-tiktok",
    "canonicalUrl": "https://clawhub.ai/stoxca/download-video-tiktok",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/download-video-tiktok",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=download-video-tiktok",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "KBLICENSE.txt",
      "metadata.md",
      "advanced.md",
      "download_latest.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/download-video-tiktok"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/download-video-tiktok",
    "downloadUrl": "https://openagent3.xyz/downloads/download-video-tiktok",
    "agentUrl": "https://openagent3.xyz/skills/download-video-tiktok/agent",
    "manifestUrl": "https://openagent3.xyz/skills/download-video-tiktok/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/download-video-tiktok/agent.md"
  }
}
```
## Documentation

### Vue d'ensemble

OpenClaw permet de télécharger la dernière vidéo (ou plusieurs) d'un compte TikTok public
via yt-dlp. Avant tout code ou exécution, lis cette documentation complète.

### Prérequis

Vérifier et installer yt-dlp si nécessaire :

pip install -U yt-dlp --break-system-packages 2>/dev/null || pip install yt-dlp
yt-dlp --version

### Types d'opérations

Ce skill supporte quatre types d'opérations. Détermine lesquelles l'utilisateur souhaite :

Download rapide — Téléchargement de la dernière vidéo d'un compte
Download multiple — Téléchargement des N dernières vidéos
Métadonnées seules — Récupérer infos/stats sans télécharger la vidéo
Vidéo directe — Télécharger depuis une URL de vidéo spécifique

### 1. Download Rapide — Dernière vidéo d'un compte

Quand l'utiliser : L'utilisateur donne un @username ou une URL de profil

Étapes :

Normaliser le username (supprimer le @ si présent)
Construire l'URL du profil : https://www.tiktok.com/@{username}
Récupérer les métadonnées de la dernière vidéo (--playlist-items 1 --no-download)
Afficher les infos à l'utilisateur (titre, date, durée)
Télécharger avec la commande optimale
Confirmer le succès et donner le chemin du fichier

Commande :

yt-dlp \\
  --playlist-items 1 \\
  --format "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" \\
  --merge-output-format mp4 \\
  --output "/home/claude/%(uploader_id)s_%(upload_date)s_%(id)s.%(ext)s" \\
  "https://www.tiktok.com/@{username}"

Vérifier le résultat :

ls -lh /home/claude/*.mp4

### 2. Download Multiple — N dernières vidéos

Quand l'utiliser : L'utilisateur veut plusieurs vidéos (--playlist-items 1-N)

Étapes :

Demander combien de vidéos (si non précisé, défaut = 5)
Construire la commande avec --playlist-items 1-N
Ajouter --download-archive pour éviter les doublons
Télécharger avec progression
Lister les fichiers téléchargés

Commande :

yt-dlp \\
  --playlist-items 1-{N} \\
  --format "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" \\
  --merge-output-format mp4 \\
  --download-archive /home/claude/tiktok_archive.txt \\
  --output "/home/claude/%(uploader_id)s/%(upload_date)s_%(id)s.%(ext)s" \\
  "https://www.tiktok.com/@{username}"

### 3. Métadonnées seules

Quand l'utiliser : L'utilisateur veut les infos sans télécharger

Lire : references/metadata.md pour les champs disponibles et la commande complète

Commande rapide :

yt-dlp \\
  --playlist-items 1 \\
  --skip-download \\
  --write-info-json \\
  --print "%(uploader_id)s | %(upload_date)s | %(duration)ss | %(view_count)s vues | %(title)s" \\
  "https://www.tiktok.com/@{username}"

### 4. Vidéo directe depuis une URL

Quand l'utiliser : L'utilisateur fournit une URL de vidéo directe

Commande :

yt-dlp \\
  --format "bestvideo[ext=mp4]+bestaudio[ext=m4a]/best[ext=mp4]/best" \\
  --merge-output-format mp4 \\
  --output "/home/claude/%(uploader_id)s_%(id)s.%(ext)s" \\
  "{url_de_la_video}"

### Gestion des erreurs courantes

ErreurCauseSolutionHTTP Error 403Rate limiting TikTokAjouter --sleep-interval 3 --max-sleep-interval 6Unable to extractyt-dlp obsolètepip install -U yt-dlp --break-system-packagesPrivate accountCompte privéUtiliser --cookies-from-browser chrome si connectéNo video formatsGéo-restrictionAjouter --geo-bypassSign in requiredContenu restreintFournir cookies via --cookies cookies.txtMerge requires ffmpegffmpeg absentapt-get install ffmpeg -y

### Normalisation du username

# Accepte tous ces formats :
# @moncompte  →  moncompte
# moncompte   →  moncompte
# https://www.tiktok.com/@moncompte  →  moncompte

def normalize(input_str):
    if "tiktok.com/@" in input_str:
        return input_str.split("tiktok.com/@")[-1].split("/")[0]
    return input_str.lstrip("@").strip()

### Fichiers de référence

Charge ces références selon le besoin :

references/metadata.md

Quand : Récupération de métadonnées, champs JSON disponibles
Contient : Tous les champs yt-dlp disponibles, formats de print, export JSON

references/advanced.md

Quand : Suppression watermark, cookies, proxy, headers personnalisés
Contient : Techniques avancées, contournement restrictions, options yt-dlp complètes

KBLICENSE.txt

Quand : Questions sur les droits d'utilisation ou les CGU
Contient : Conditions d'utilisation, usages autorisés et interdits

### Directives de sortie

Toujours afficher les métadonnées avant le téléchargement (titre, date, durée)
Confirmer le chemin du fichier téléchargé
Indiquer la taille du fichier final
En cas d'erreur, proposer la solution directement

### Exemples de requêtes

Download rapide :

"Télécharge la dernière vidéo de @lecompte"
"Récupère le dernier post TikTok de moncompte"
"Download la dernière vidéo de https://www.tiktok.com/@user"

Download multiple :

"Télécharge les 5 dernières vidéos de @user"
"Récupère les 10 dernières vidéos du compte @toto"

Métadonnées :

"Donne-moi les infos de la dernière vidéo de @user"
"Quel est le titre et la date du dernier post de @compte"

URL directe :

"Télécharge cette vidéo TikTok : https://www.tiktok.com/@user/video/123456"
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: stoxca
- Version: 1.0.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/download-video-tiktok)
- [Send to Agent page](https://openagent3.xyz/skills/download-video-tiktok/agent)
- [JSON manifest](https://openagent3.xyz/skills/download-video-tiktok/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/download-video-tiktok/agent.md)
- [Download page](https://openagent3.xyz/downloads/download-video-tiktok)