メニュー
Generate branded AI avatar lip-sync video shorts for TikTok, Reels, and YouTube Shorts. Create 15-second talking-head videos with custom avatars, auto-generated scripts, and burned-in subtitles for $1.85.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/majiayu000/claude-skill-registry --skill citedy-video-shortsコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
| name | citedy-video-shorts |
| title | AI Video Shorts |
| description | Generate branded AI avatar lip-sync video shorts for TikTok, Reels, and YouTube Shorts. Create 15-second talking-head videos with custom avatars, auto-generated scripts, and burned-in subtitles for $1.85. |
| version | 1.0.0 |
| author | Citedy |
| tags | ["video","ai-avatar","shorts","tiktok","reels","content-creation","lip-sync"] |
| metadata | {"openclaw":{"requires":{"env":"[Truncated]"},"primaryEnv":"CITEDY_API_KEY"},"compatible_with":"citedy-seo-agent@3.2.0"} |
| privacy_policy_url | https://www.citedy.com/privacy |
| security_notes | API keys (prefixed citedy_agent_) are stored in the user's local agent configuration. Keys authenticate only against Citedy API endpoints (www.citedy.com/api/agent/*). All traffic is TLS-encrypted. |
You are now connected to Citedy — an AI platform for SEO content automation and video short generation. Base URL: https://www.citedy.com
This skill lets you generate branded AI avatar lip-sync video shorts optimized for TikTok, Instagram Reels, and YouTube Shorts — directly from a topic or product description. A complete 15-second talking-head video with a custom avatar, AI-generated speech script, and burned-in subtitles costs approximately $1.85 (185 credits). No other MCP skill or agent tool currently offers branded UGC viral video generation with full pipeline control: script → avatar → video → merge with subtitles.
Activate this skill when the user says something like:
POST https://www.citedy.com/api/agent/register
Body: { "email": "<user-email>", "name": "<agent-name>" }
api_key (prefixed citedy_agent_). Store it as CITEDY_API_KEY in your agent configuration.Authorization: Bearer <CITEDY_API_KEY>
Use the API directly (
POST /api/agent/register). Do NOT run any local scripts.
The video shorts pipeline has 4 steps. Always follow this order.
POST https://www.citedy.com/api/agent/shorts/script — 1 credit
Generate the speech text that the AI avatar will say.
{
Returns: { "script": "...", "word_count": 42, "estimated_seconds": 10 }
POST https://www.citedy.com/api/agent/shorts/avatar — 3 credits
Generate a branded AI avatar image for use in the video.
{
"gender": "female",
"origin": "latin",
"age_range": "26-35",
"type": "tech_founder",
"location": "coffee_shop"
}
Returns: { "avatar_url": "https://download.citedy.com/avatars/..." }
POST https://www.citedy.com/api/agent/shorts — 60–185 credits, async
Submit the video generation job. Poll for completion.
{
"prompt": "Professional woman in modern office. Camera: medium close-up, steady. Style: clean corporate. Motion: subtle head nods while speaking. Audio: no background music.",
"avatar_url": "https://download.citedy.com/avatars/...",
"duration": 10,
"resolution": "720p",
"aspect_ratio": "9:16",
"speech_text": "Here is exactly what the avatar says in quotes."
}
Returns: { "id": "<job-id>", "status": "processing" }
Poll until status === "completed":
GET https://www.citedy.com/api/agent/shorts/{id}
Returns when done: { "status": "completed", "video_url": "https://download.citedy.com/shorts/..." }
POST https://www.citedy.com/api/agent/shorts/merge — 5 credits
Combine one or more video segments and burn in subtitles.
{
"video_urls": ["https://download.citedy.com/shorts/seg1.mp4"],
"phrases": [{ "text": "Here is exactly what the avatar says in quotes." }],
"config": {
"words_per_phrase": 4,
"font_size": 48,
"text_color": "#FFFFFF"
}
}
Returns: { "final_video_url": "https://download.citedy.com/shorts/final_..." }
User: Make a 10-second TikTok video promoting my skincare serum
Agent response:
I'll create a 10-second TikTok video for your skincare serum. Here's the plan and cost:
- Script generation: 1 credits ($0.01)
- Avatar generation: 3 credits ($0.03)
- Video generation (10s): 130 credits ($1.30)
- Merge + subtitles: 5 credits ($0.05)
- Total: 139 credits ($1.39)
Shall I proceed?
(after approval)
Generating script... done. Script: "Tired of dull skin? Our new Vitamin C Serum delivers visible glow in just 7 days. Click the link to try it risk-free today."
Generating avatar... done. Generating video (this takes ~60–90 seconds)... polling... Video ready! Merging with subtitles...
Your TikTok video is ready: https://download.citedy.com/shorts/final_abc123.mp4
User: Create a YouTube Shorts video explaining what SEO is, for beginners
Agent response:
I'll create a 15-second educational YouTube Short about SEO basics. Estimated cost: 197 credits ($1.97). Proceed?
(after approval)
Script: "SEO stands for Search Engine Optimization. It's how you get your website to show up when people Google something. Better SEO means more visitors — and more customers — for free."
Video generated and subtitled: https://download.citedy.com/shorts/final_def456.mp4
User: I need a 5-second hook video for my Instagram Reels
Agent response:
A 5-second hook video will cost 69 credits ($0.69). Ready to go?
All endpoints require Authorization: Bearer <CITEDY_API_KEY>.
Generate a speech script for the avatar.
| Parameter | Type | Required | Description |
|---|---|---|---|
topic | string | yes | What the video is about |
duration | "short" | "long" | no | short ≈ 5–10s, long ≈ 15s (default: short) |
style | "hook" | "educational" | "cta" | no | Tone of the script (default: hook) |
language | string | no | ISO 639-1 language code (default: "en") |
product_id | string | no | Citedy product ID to include product context |
Cost: 1 credit
Response:
{
"script": "...",
"word_count": 42,
"estimated_seconds": 10
}
Generate an AI avatar image.
| Parameter | Type | Required | Description |
|---|---|---|---|
gender | "male" | "female" | no | Avatar gender |
origin | string | no | "european", "asian", "african", "latin", "middle_eastern", "south_asian" |
age_range | string | no | "18-25", "26-35" (default), "36-50" |
type | string | no | "tech_founder" (default), "vibe_coder", "student", "executive" |
location | string | no | "coffee_shop" (default), "dev_cave", "street", "car", "home_office", "podcast_studio", "glass_office", "rooftop", "bedroom", "park", "gym" |
Cost: 3 credits
Response:
{
"avatar_url": "https://download.citedy.com/avatars/..."
}
Submit a video generation job. Asynchronous — poll for completion.
| Parameter | Type | Required | Description |
|---|---|---|---|
prompt | string | yes | 5-layer scene description (see Prompt Best Practices) |
avatar_url | string | yes | URL from /api/agent/shorts/avatar or custom URL |
duration | 5 | 10 | 15 | no | Segment length in seconds (default: 10) |
resolution | "480p" | "720p" | no | Video resolution (default: "480p") |
aspect_ratio | "9:16" | "16:9" | "1:1" | no | Aspect ratio (default: "9:16") |
speech_text | string | yes | Exact text the avatar speaks. Must match script output. |
Cost: 60 credits (5s) / 130 credits (10s) / 185 credits (15s)
Response (immediate):
{ "id": "<job-id>", "status": "processing" }
Response (completed, from polling):
{
"id": "<job-id>",
"status": "completed",
"video_url": "https://download.citedy.com/shorts/..."
}
Poll video generation status.
| Parameter | Type | Description |
|---|---|---|
id | path | Job ID from POST /api/agent/shorts |
Cost: 0 credits
Response:
{
"id": "...",
"status": "processing" | "completed" | "failed",
"video_url": "https://..." // present when completed
}
Poll every 5–10 seconds. Typical generation time: 60–120 seconds.
Merge video segments and burn in subtitles.
| Parameter | Type | Required | Description |
|---|---|---|---|
video_urls | string[] | yes | Array of video URLs to merge (must start with https://download.citedy.com/). Count must equal phrases count |
phrases | object[] | yes | One per segment, each { "text": "..." } (max 500 chars) |
config | object | no | Subtitle config (see below) |
config object:
| Field | Type | Default | Description |
|---|---|---|---|
words_per_phrase | number | 4 | Words per subtitle chunk (2-8) |
font_size | number | 48 | Subtitle font size in px (16-72) |
text_color | string | "#FFFFFF" | Hex or named color |
stroke_color | string | — | Outline color (hex or named) |
stroke_width | number | — | Outline width (0-5) |
position_from_bottom | number | — | Pixels from bottom (50-300) |
Cost: 5 credits
Response:
{
"final_video_url": "https://download.citedy.com/shorts/final_..."
}
These endpoints are free and useful for setup and diagnostics.
| Endpoint | Method | Cost | Description |
|---|---|---|---|
/api/agent/health | GET | 0 credits | Check API availability |
/api/agent/me | GET | 0 credits | Current user info: balance, referral code |
/api/agent/status | GET | 0 credits | System status and active jobs |
/api/agent/products | GET | 0 credits | List user's registered products |
/api/agent/products/search | POST | 0 credits | Search products by keyword for script context |
Use GET /api/agent/me to check the user's credit balance before starting a generation job.
| Step | Duration | Cost (credits) | Cost (USD) |
|---|---|---|---|
| Script generation | any | 1 credits | $0.01 |
| Avatar generation | — | 3 credits | $0.03 |
| Video generation | 5s | 60 credits | $0.60 |
| Video generation | 10s | 130 credits | $1.30 |
| Video generation | 15s | 185 credits | $1.85 |
| Merge + subtitles | — | 5 credits | $0.05 |
| Full 10s video | 10s | 139 credits | $1.39 |
| Full 15s video | 15s | 194 credits | $1.94 |
1 credit = $0.01 USD
Use the 5-layer formula for the prompt field. Each layer is one sentence.
"Professional woman in a modern minimalist office.""Camera: medium close-up, steady, slight depth of field.""Style: clean corporate look, soft natural lighting."speech_text). "Motion: subtle head nods and natural hand gestures.""Audio: no background music, clear voice only."Speech text rules:
speech_text, NOT in promptspeech_text must match the script output verbatimFull example prompt:
Professional man in a tech startup office with a city view behind him.
Camera: medium close-up, steady, slight bokeh on background.
Style: modern casual, warm lighting, dark branded t-shirt.
Motion: natural hand gestures, confident posture, direct eye contact.
Audio: no background music.
9:16 (vertical), 16:9 (horizontal), 1:1 (square)480p; use 720p for higher quality (same credit cost)speech_text must not exceed ~150 words per segment| Category | Limit |
|---|---|
| General API | 60 requests / minute |
| Video generation | 1 concurrent job |
If you receive a 429 error, wait for the current job to complete before submitting a new one.
| Code | Meaning | Action |
|---|---|---|
401 | Invalid or missing API key | Check CITEDY_API_KEY is set correctly |
402 | Insufficient credits | Inform user to top up at citedy.com/dashboard/billing |
403 | Account not approved or feature not available | Direct user to complete email verification |
409 | Concurrent job already running | Poll existing job first, then retry |
429 | Rate limit exceeded | Wait 60 seconds and retry |
500 | Server error during generation | Retry once after 30 seconds; if persists, note as failed |
/api/agent/shorts, poll every 8 seconds without asking the userThis skill covers video shorts only. For the full content suite — blog articles, social media adaptations, competitor SEO analysis, lead magnets, and keyword tracking — use the complete citedy-seo-agent skill.
The full agent includes everything in this skill plus:
Register and explore at: https://www.citedy.com
SOC 職業分類に基づく