[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M770G2NH5ME6S37NQZXJFP7C":3,"skill-same:01M770G2NH5ME6S37NQZXJFP7C":52},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":29,"commitSha":30,"skillDirectory":31,"forksCount":32,"repositoryHtmlUrl":33,"repositoryHomepageUrl":6,"ownerHtmlUrl":34,"ownerBlogUrl":35,"ownerDescription":36,"updatedAt":37,"install":38,"resources":51},"01M770G2NH5ME6S37NQZXJFP7C","rawugc-api",null,"Call the RawUGC API to generate AI videos\u002Fimages\u002Fmusic, manage content (personas, products, styles, characters), schedule social media posts, research TikTok content, and analyze viral videos. Use when the user wants to interact with any RawUGC API endpoint.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftfcbot\u002Fai-ugc\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: rawugc-api\ndescription: Call the RawUGC API to generate AI videos\u002Fimages\u002Fmusic, manage content (personas, products, styles, characters), schedule social media posts, research TikTok content, and analyze viral videos. Use when the user wants to interact with any RawUGC API endpoint.\nrequires:\n  env:\n    - RAWUGC_API_KEY\ncompatibility: Requires RAWUGC_API_KEY (Bearer token for https:\u002F\u002Frawugc.com\u002Fapi\u002Fv1). Obtain from RawUGC dashboard.\nhomepage: https:\u002F\u002Fgithub.com\u002Ftfcbot\u002Frawugc-skills\nsource: https:\u002F\u002Fgithub.com\u002Ftfcbot\u002Frawugc-skills\n---\n\n# RawUGC API\n\nProcedural knowledge for agents to call the RawUGC API. All requests require an API key from the RawUGC dashboard, passed via environment variable.\n\n## Authentication\n\n- **Environment variable**: Read the API key from `RAWUGC_API_KEY`. The key is created in the RawUGC dashboard and must be kept secret; do not hardcode or log it.\n- **Header**: Send on every request: `Authorization: Bearer \u003Cvalue of RAWUGC_API_KEY>`.\n- If `RAWUGC_API_KEY` is missing or empty, inform the user they must set it and obtain a key from the RawUGC dashboard.\n\n## Base URL\n\n- **Production**: `https:\u002F\u002Frawugc.com\u002Fapi\u002Fv1`\n- All paths below are relative to this base.\n\n## API Versioning\n\nRawUGC uses date-based API versioning. The current latest version is `2026-03-06`.\n\n- **`RawUGC-Version` request header**: Override the version per-request (recommended).\n- **API key pinned version**: Set when creating the key in the dashboard.\n- **Fallback**: Latest version (`2026-03-06`) if neither is set.\n\nAlways send `RawUGC-Version: 2026-03-06` in requests to ensure consistent behavior.\n\n---\n\n## Video Generation\n\n### POST \u002Fvideos\u002Fgenerate\n\nInitiate video generation.\n\n**Request body (JSON)**:\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `model` | string | Yes | `sora-2-text-to-video`, `sora-2-image-to-video`, `kling-2.6\u002Fmotion-control`, `veo3`, `veo3_fast` |\n| `prompt` | string | For text-to-video \u002F veo3 | Text description (1-5000 chars) |\n| `imageUrls` | string[] | For image-to-video \u002F kling | URLs, max 10. Veo3\u002Fveo3_fast accept up to 2 optional images. |\n| `videoUrls` | string[] | For kling | URLs, max 1. Required for `kling-2.6\u002Fmotion-control` |\n| `aspectRatio` | string | No | Sora: `portrait`\u002F`landscape`. Veo3: `16:9`\u002F`9:16`\u002F`Auto` |\n| `nFrames` | string | No | `\"10\"` or `\"15\"` (Sora only) |\n| `selectedCharacter` | string | No | Character username (e.g. `rawugc.mia`) |\n| `characterOrientation` | string | No | `image` or `video` (kling only) |\n| `mode` | string | No | `720p` or `1080p` (kling only) |\n\n**Response (201)**: `videoId`, `model`, `status`, `creditsUsed`, `newBalance`, `estimatedCompletionTime`, `createdAt`.\n\n### GET \u002Fvideos\u002F:videoId\n\nGet video status. Returns `videoId`, `status`, `model`, `prompt`, `creditsUsed`, `url` (when completed), `createdAt`, `completedAt`, `failCode`, `failMessage`, `versions` (edit history array).\n\n### GET \u002Fvideos\n\nList videos. Query: `status`, `limit` (1-100, default 50), `page`. Returns `videos` array + `pagination`.\n\n### POST \u002Fvideos\u002Fcaptions\n\nAdd styled captions to a completed video. Costs 1 credit.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `videoId` | string | Yes | Video identifier (vid_xxx) |\n| `language` | string | No | Language code (e.g. `en`). Defaults to auto-detect |\n\n**Response (200)**: `videoId`, `url`, `version`, `operation`, `creditsUsed`.\n\n### POST \u002Fvideos\u002Foverlay\n\nAdd text overlay to a completed video.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `videoId` | string | Yes | Video identifier (vid_xxx) |\n| `text` | string | Yes | Overlay text (1-500 chars) |\n| `position` | string | No | `top`, `center`, or `bottom` |\n| `fontSize` | integer | No | 8-200 pixels |\n| `topBottomMargin` | integer | No | 0-500 pixels |\n| `strokeThickness` | number | No | 0-10 |\n\n**Response (200)**: `videoId`, `url`, `version`, `operation`, `creditsUsed`.\n\n---\n\n## Image Generation\n\n### POST \u002Fimages\u002Fgenerate\n\nGenerate AI images using Nano Banana models. Async -- poll GET \u002Fimages\u002F:imageId.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `model` | string | Yes | `nano-banana-2` (text-to-image, 4 credits) or `google\u002Fnano-banana-edit` (image editing, 2 credits) |\n| `prompt` | string | Yes | Text description or edit instruction (1-20000 chars) |\n| `imageUrls` | string[] | For editing | Source images. Required for `google\u002Fnano-banana-edit`. Optional for `nano-banana-2` (reference images, max 14). |\n| `aspectRatio` | string | No | For `nano-banana-2`: `1:1`, `16:9`, `9:16`, `auto`, etc. |\n| `imageSize` | string | No | For `google\u002Fnano-banana-edit`: `1:1`, `16:9`, `9:16`, `auto`, etc. |\n| `resolution` | string | No | For `nano-banana-2`: `1K`, `2K`, `4K` |\n| `outputFormat` | string | No | `png`, `jpeg`, `jpg` |\n| `googleSearch` | boolean | No | Use Google Web Search grounding (`nano-banana-2` only) |\n\n**Response (201)**: `imageId`, `model`, `status`, `creditsUsed`, `newBalance`, `estimatedCompletionTime`, `createdAt`.\n\n### GET \u002Fimages\u002F:imageId\n\nGet image status. Returns `imageId`, `status`, `model`, `prompt`, `url` (when completed), `imageSize`, `resolution`, `outputFormat`, `creditsUsed`, `createdAt`, `completedAt`, `failCode`, `failMessage`.\n\n### GET \u002Fimages\n\nList images. Query: `status`, `limit` (1-100, default 20), `page`. Returns `images` array + `pagination`.\n\n---\n\n## Music Generation\n\n### POST \u002Fmusic\u002Fgenerate\n\nGenerate AI music using Suno models. 3 credits per generation. Async -- poll GET \u002Fmusic\u002F:musicId.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `prompt` | string | Yes | Music description (1-2000 chars) |\n| `model` | string | No | `V3_5`, `V4`, `V4_5`, `V4_5PLUS`, `V4_5ALL`, `V5` (default: `V5`) |\n| `instrumental` | boolean | No | Instrumental only, no vocals (default: true) |\n| `title` | string | No | Track title (max 200 chars). Enables custom mode with `style`. |\n| `style` | string | No | Style descriptor (max 500 chars, e.g. `lo-fi hip hop`) |\n\n**Response (201)**: `musicId`, `model`, `status`, `creditsUsed`, `newBalance`, `estimatedCompletionTime`, `createdAt`.\n\n### GET \u002Fmusic\u002F:musicId\n\nGet music status. Returns `musicId`, `status`, `model`, `prompt`, `audioUrl` (when completed), `albumArtUrl`, `duration`, `title`, `creditsUsed`, `createdAt`, `completedAt`, `failCode`, `failMessage`.\n\n### GET \u002Fmusic\n\nList music tracks. Query: `status`, `limit` (1-100, default 20), `page`. Returns `tracks` array + `pagination`.\n\n---\n\n## Upload\n\n### POST \u002Fupload\n\nUpload a video or image file. Returns a URL for use in generation requests (`imageUrls`, `videoUrls`) or `analyze-video`. Max 100MB.\n\n**Request**: `multipart\u002Fform-data` with `file` field. Accepted types: `video\u002Fmp4`, `video\u002Fquicktime`, `video\u002Fwebm`, `image\u002Fpng`, `image\u002Fjpeg`, `image\u002Fwebp`.\n\n**Response (200)**: `url`, `contentType`, `size`.\n\n---\n\n## Characters\n\n### GET \u002Fcharacters\n\nList all available AI characters (built-in + custom). Returns `characters` array, `count`, `adminCount`, `userCount`.\n\n### GET \u002Fcharacters\u002F:characterId\n\nGet a character by ID. Returns `_id`, `username`, `displayName`, `description`, `videoPreviewUrl`, `type` (`admin`\u002F`user`), `isActive`, `createdAt`, `updatedAt`.\n\n---\n\n## Personas (CRUD)\n\nPersonas define target audiences for content plan generation.\n\n- **GET \u002Fpersonas** -- List all. Returns `personas` array + `count`.\n- **POST \u002Fpersonas** -- Create. Body: `name` (required, max 200), `description` (required, max 5000). Returns `id`.\n- **GET \u002Fpersonas\u002F:personaId** -- Get one.\n- **PATCH \u002Fpersonas\u002F:personaId** -- Update. Body: `name`, `description` (both optional).\n- **DELETE \u002Fpersonas\u002F:personaId** -- Delete.\n\n**PersonaResponse**: `_id`, `organizationId`, `name`, `description`, `createdAt`, `updatedAt`.\n\n---\n\n## Messaging (CRUD)\n\nBrand\u002Fpositioning messaging templates.\n\n- **GET \u002Fmessaging** -- List all. Returns `messages` array + `count`.\n- **POST \u002Fmessaging** -- Create. Body: `name` (required, max 200), `body` (required, max 5000). Returns `id`.\n- **GET \u002Fmessaging\u002F:messageId** -- Get one.\n- **PATCH \u002Fmessaging\u002F:messageId** -- Update. Body: `name`, `body` (both optional).\n- **DELETE \u002Fmessaging\u002F:messageId** -- Delete.\n\n**MessagingResponse**: `_id`, `organizationId`, `name`, `body`, `createdAt`, `updatedAt`.\n\n---\n\n## Products (CRUD)\n\nProducts for video generation.\n\n- **GET \u002Fproducts** -- List all. Returns `products` array + `count`.\n- **POST \u002Fproducts** -- Create. Body: `name` (required, max 200), `photos` (required, URL array), `description` (max 1000), `messaging` (max 5000). Returns `id`.\n- **GET \u002Fproducts\u002F:productId** -- Get one.\n- **PATCH \u002Fproducts\u002F:productId** -- Update. Body: `name`, `description`, `photos`, `messaging` (all optional).\n- **DELETE \u002Fproducts\u002F:productId** -- Delete.\n\n**ProductResponse**: `_id`, `name`, `description`, `photos`, `messaging`, `createdAt`, `updatedAt`.\n\n---\n\n## Styles (CRUD)\n\nVideo\u002Fimage creative styles with optional prompt templates.\n\n- **GET \u002Fstyles** -- List all (built-in + custom). Query: `type` (`video`\u002F`image`). Returns `styles` array + `count`.\n- **POST \u002Fstyles** -- Create. Body: `name` (required, max 200), `description` (max 1000), `type` (`video`\u002F`image`), `aspectRatio` (`portrait`\u002F`landscape`\u002F`square`), `promptTemplate` (max 5000, supports `{productName}`, `{messaging}`, `{character}` placeholders). Returns `id`.\n- **GET \u002Fstyles\u002F:styleId** -- Get one.\n- **PATCH \u002Fstyles\u002F:styleId** -- Update. All fields optional.\n- **DELETE \u002Fstyles\u002F:styleId** -- Delete.\n\n**StyleResponse**: `_id`, `name`, `description`, `type`, `aspectRatio`, `styleId`, `promptTemplate`, `isAdmin`, `isStandard`.\n\n---\n\n## Social Scheduling\n\n### GET \u002Fsocial\u002Faccounts\n\nList connected social accounts (max 3 per org). Returns `accounts` array + `count`. Each account: `accountId`, `platform` (`tiktok`\u002F`instagram`\u002F`youtube`), `username`, `displayName`, `profilePicture`, `isActive`.\n\n### POST \u002Fsocial\u002Faccounts\n\nSync connected accounts from the scheduling provider. Returns `{ success: boolean }`.\n\n### DELETE \u002Fsocial\u002Faccounts\u002F:accountId\n\nDisconnect a social account. Returns `{ success: boolean }`.\n\n### POST \u002Fsocial\u002Fposts\n\nSchedule, draft, or immediately publish a video to social media.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `videoUrl` | string | Yes | URL of video to post |\n| `accountIds` | string[] | Yes | Target account IDs |\n| `mode` | string | Yes | `schedule`, `draft`, or `now` |\n| `scheduledFor` | integer | For schedule | Unix timestamp (ms) |\n| `timezone` | string | No | IANA timezone (default: `UTC`) |\n| `content` | string | No | Caption (max 2200 chars) |\n| `videoId` | string | No | RawUGC video ID to link |\n| `publishToInbox` | boolean | No | Send to TikTok Creator Inbox |\n| `tiktokPrivacyLevel` | string | No | `SELF_ONLY`, `PUBLIC_TO_EVERYONE`, `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR` |\n| `tiktokAllowComment` | boolean | No | Allow TikTok comments |\n| `tiktokAllowDuet` | boolean | No | Allow TikTok duets |\n| `tiktokAllowStitch` | boolean | No | Allow TikTok stitches |\n| `tiktokCommercialContentType` | string | No | `none`, `brand_organic`, `brand_content` |\n\n**Response (201)**: SocialPost object.\n\n### GET \u002Fsocial\u002Fposts\n\nList posts. Query: `fromDate` (ms), `toDate` (ms), `includeDrafts` (boolean). Returns `posts` array + `count`.\n\n### GET \u002Fsocial\u002Fposts\u002F:postId\n\nGet a post.\n\n### PATCH \u002Fsocial\u002Fposts\u002F:postId\n\nUpdate a post. Body: `content`, `scheduledFor`, `timezone`, `accountIds` (at least one field required).\n\n### DELETE \u002Fsocial\u002Fposts\u002F:postId\n\nDelete a post. Returns `{ success: boolean }`.\n\n### POST \u002Fsocial\u002Fposts\u002F:postId\u002Freschedule\n\nReschedule a post. Body: `scheduledFor` (required, ms), `timezone`.\n\n### POST \u002Fsocial\u002Fposts\u002F:postId\u002Fpublish\n\nImmediately publish a draft post.\n\n**SocialPost**: `postId`, `platforms`, `status` (`draft`\u002F`scheduled`\u002F`published`\u002F`failed`), `scheduledFor`, `timezone`, `content`, `videoUrl`, `createdAt`, `publishedAt`.\n\n---\n\n## Viral Library\n\n### GET \u002Fviral-library\u002Fvideos\u002F:videoId\n\nGet a viral library video with full AI analysis (hooks, keyframes, performance insights). Returns ViralLibraryVideo.\n\n### GET \u002Fviral-library\u002Fsearch\n\nSemantic search across analyzed videos. Query: `q` (required, natural language), `limit` (1-50, default 20). Returns `results` (array of `{ video, score }`), `query`, `total`.\n\n---\n\n## Research\n\n### POST \u002Fscrape-tiktok\n\nScrape TikTok videos. Costs 3 credits.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `query` | string | Yes | Search keyword, hashtag, or query (max 500) |\n| `mode` | string | No | `keyword`, `hashtag`, `search` (default: `keyword`) |\n| `limit` | integer | No | 1-10 (default: 10) |\n\n**Response (200)**: `scrapeId` (use with content-plans), `count`, `videos` (array with `id`, `url`, `author`, `description`, `stats`, `duration`, `hashtags`, `thumbnail`, `videoUrl`).\n\n### POST \u002Fcontent-plans\n\nGenerate a content plan from scraped videos. Costs 3 credits.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `scrapeId` | string | Yes | From scrape-tiktok response |\n| `brief` | string | Yes | Content plan goals (max 5000) |\n\n**Response (200)**: `planId`, `scrapeId`, `brief`, `topWins`, `gapsToTest`, `blueprints` (array with `category`, `strategy`, `evidence`, `contentIdeas`).\n\n### GET \u002Fcontent-plans\n\nList all content plans. Returns `plans` array + `count`.\n\n### POST \u002Fanalyze-video\n\nAnalyze any video URL (social links or direct URLs). Costs 1 credit. Max 150MB.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `videoUrl` | string | Yes | Video URL to analyze |\n| `prompt` | string | No | Custom analysis prompt (max 5000) |\n\n**Response (200)**: `summary`, `hook`, `keyframes` (array with `timestamp`, `type`, `description`, `visual`, `audio`, `text`), `durationSeconds`, `tags`, `whyItPerformed`, `attributesToCopy`, `hooksToTest`.\n\n---\n\n## Errors\n\nAll error responses use RFC 7807 Problem Details (JSON): `type`, `title`, `status`, `detail`, `instance`, `errors`.\n\n| Status | Meaning |\n|--------|---------|\n| 400 | Validation error. Surface `detail` and `errors` to user. |\n| 401 | Auth error. Check `RAWUGC_API_KEY`. |\n| 402 | Insufficient credits. Add credits in dashboard. |\n| 403 | Insufficient scope. API key lacks permissions. |\n| 404 | Resource not found. |\n| 429 | Rate limit exceeded. Check `X-RateLimit-Reset` header. |\n| 500 | Server error. Retry or contact support. |\n\n## Rate Limits\n\n- API Key: 10 req\u002Fmin. Session: 20 req\u002Fmin.\n- Headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (unix timestamp).\n\n## Workflow: Generate then poll\n\n1. **Generate**: POST to the generation endpoint. Note the returned ID (`videoId`\u002F`imageId`\u002F`musicId`).\n2. **Poll**: GET the status endpoint periodically (10-30s). Use exponential backoff.\n3. **Finish**: When `status === 'completed'`, use the result URL. When `failed`, surface error to user.\n4. **Edit** (video only): POST to `\u002Fvideos\u002Fcaptions` or `\u002Fvideos\u002Foverlay`.\n\nFor full request\u002Fresponse shapes, see [reference.md](reference.md).\n","# RawUGC API\n\nProcedural knowledge for agents to call the RawUGC API. All requests require an API key from the RawUGC dashboard, passed via environment variable.\n\n## Authentication\n\n- **Environment variable**: Read the API key from `RAWUGC_API_KEY`. The key is created in the RawUGC dashboard and must be kept secret; do not hardcode or log it.\n- **Header**: Send on every request: `Authorization: Bearer \u003Cvalue of RAWUGC_API_KEY>`.\n- If `RAWUGC_API_KEY` is missing or empty, inform the user they must set it and obtain a key from the RawUGC dashboard.\n\n## Base URL\n\n- **Production**: `https:\u002F\u002Frawugc.com\u002Fapi\u002Fv1`\n- All paths below are relative to this base.\n\n## API Versioning\n\nRawUGC uses date-based API versioning. The current latest version is `2026-03-06`.\n\n- **`RawUGC-Version` request header**: Override the version per-request (recommended).\n- **API key pinned version**: Set when creating the key in the dashboard.\n- **Fallback**: Latest version (`2026-03-06`) if neither is set.\n\nAlways send `RawUGC-Version: 2026-03-06` in requests to ensure consistent behavior.\n\n---\n\n## Video Generation\n\n### POST \u002Fvideos\u002Fgenerate\n\nInitiate video generation.\n\n**Request body (JSON)**:\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `model` | string | Yes | `sora-2-text-to-video`, `sora-2-image-to-video`, `kling-2.6\u002Fmotion-control`, `veo3`, `veo3_fast` |\n| `prompt` | string | For text-to-video \u002F veo3 | Text description (1-5000 chars) |\n| `imageUrls` | string[] | For image-to-video \u002F kling | URLs, max 10. Veo3\u002Fveo3_fast accept up to 2 optional images. |\n| `videoUrls` | string[] | For kling | URLs, max 1. Required for `kling-2.6\u002Fmotion-control` |\n| `aspectRatio` | string | No | Sora: `portrait`\u002F`landscape`. Veo3: `16:9`\u002F`9:16`\u002F`Auto` |\n| `nFrames` | string | No | `\"10\"` or `\"15\"` (Sora only) |\n| `selectedCharacter` | string | No | Character username (e.g. `rawugc.mia`) |\n| `characterOrientation` | string | No | `image` or `video` (kling only) |\n| `mode` | string | No | `720p` or `1080p` (kling only) |\n\n**Response (201)**: `videoId`, `model`, `status`, `creditsUsed`, `newBalance`, `estimatedCompletionTime`, `createdAt`.\n\n### GET \u002Fvideos\u002F:videoId\n\nGet video status. Returns `videoId`, `status`, `model`, `prompt`, `creditsUsed`, `url` (when completed), `createdAt`, `completedAt`, `failCode`, `failMessage`, `versions` (edit history array).\n\n### GET \u002Fvideos\n\nList videos. Query: `status`, `limit` (1-100, default 50), `page`. Returns `videos` array + `pagination`.\n\n### POST \u002Fvideos\u002Fcaptions\n\nAdd styled captions to a completed video. Costs 1 credit.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `videoId` | string | Yes | Video identifier (vid_xxx) |\n| `language` | string | No | Language code (e.g. `en`). Defaults to auto-detect |\n\n**Response (200)**: `videoId`, `url`, `version`, `operation`, `creditsUsed`.\n\n### POST \u002Fvideos\u002Foverlay\n\nAdd text overlay to a completed video.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `videoId` | string | Yes | Video identifier (vid_xxx) |\n| `text` | string | Yes | Overlay text (1-500 chars) |\n| `position` | string | No | `top`, `center`, or `bottom` |\n| `fontSize` | integer | No | 8-200 pixels |\n| `topBottomMargin` | integer | No | 0-500 pixels |\n| `strokeThickness` | number | No | 0-10 |\n\n**Response (200)**: `videoId`, `url`, `version`, `operation`, `creditsUsed`.\n\n---\n\n## Image Generation\n\n### POST \u002Fimages\u002Fgenerate\n\nGenerate AI images using Nano Banana models. Async -- poll GET \u002Fimages\u002F:imageId.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `model` | string | Yes | `nano-banana-2` (text-to-image, 4 credits) or `google\u002Fnano-banana-edit` (image editing, 2 credits) |\n| `prompt` | string | Yes | Text description or edit instruction (1-20000 chars) |\n| `imageUrls` | string[] | For editing | Source images. Required for `google\u002Fnano-banana-edit`. Optional for `nano-banana-2` (reference images, max 14). |\n| `aspectRatio` | string | No | For `nano-banana-2`: `1:1`, `16:9`, `9:16`, `auto`, etc. |\n| `imageSize` | string | No | For `google\u002Fnano-banana-edit`: `1:1`, `16:9`, `9:16`, `auto`, etc. |\n| `resolution` | string | No | For `nano-banana-2`: `1K`, `2K`, `4K` |\n| `outputFormat` | string | No | `png`, `jpeg`, `jpg` |\n| `googleSearch` | boolean | No | Use Google Web Search grounding (`nano-banana-2` only) |\n\n**Response (201)**: `imageId`, `model`, `status`, `creditsUsed`, `newBalance`, `estimatedCompletionTime`, `createdAt`.\n\n### GET \u002Fimages\u002F:imageId\n\nGet image status. Returns `imageId`, `status`, `model`, `prompt`, `url` (when completed), `imageSize`, `resolution`, `outputFormat`, `creditsUsed`, `createdAt`, `completedAt`, `failCode`, `failMessage`.\n\n### GET \u002Fimages\n\nList images. Query: `status`, `limit` (1-100, default 20), `page`. Returns `images` array + `pagination`.\n\n---\n\n## Music Generation\n\n### POST \u002Fmusic\u002Fgenerate\n\nGenerate AI music using Suno models. 3 credits per generation. Async -- poll GET \u002Fmusic\u002F:musicId.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `prompt` | string | Yes | Music description (1-2000 chars) |\n| `model` | string | No | `V3_5`, `V4`, `V4_5`, `V4_5PLUS`, `V4_5ALL`, `V5` (default: `V5`) |\n| `instrumental` | boolean | No | Instrumental only, no vocals (default: true) |\n| `title` | string | No | Track title (max 200 chars). Enables custom mode with `style`. |\n| `style` | string | No | Style descriptor (max 500 chars, e.g. `lo-fi hip hop`) |\n\n**Response (201)**: `musicId`, `model`, `status`, `creditsUsed`, `newBalance`, `estimatedCompletionTime`, `createdAt`.\n\n### GET \u002Fmusic\u002F:musicId\n\nGet music status. Returns `musicId`, `status`, `model`, `prompt`, `audioUrl` (when completed), `albumArtUrl`, `duration`, `title`, `creditsUsed`, `createdAt`, `completedAt`, `failCode`, `failMessage`.\n\n### GET \u002Fmusic\n\nList music tracks. Query: `status`, `limit` (1-100, default 20), `page`. Returns `tracks` array + `pagination`.\n\n---\n\n## Upload\n\n### POST \u002Fupload\n\nUpload a video or image file. Returns a URL for use in generation requests (`imageUrls`, `videoUrls`) or `analyze-video`. Max 100MB.\n\n**Request**: `multipart\u002Fform-data` with `file` field. Accepted types: `video\u002Fmp4`, `video\u002Fquicktime`, `video\u002Fwebm`, `image\u002Fpng`, `image\u002Fjpeg`, `image\u002Fwebp`.\n\n**Response (200)**: `url`, `contentType`, `size`.\n\n---\n\n## Characters\n\n### GET \u002Fcharacters\n\nList all available AI characters (built-in + custom). Returns `characters` array, `count`, `adminCount`, `userCount`.\n\n### GET \u002Fcharacters\u002F:characterId\n\nGet a character by ID. Returns `_id`, `username`, `displayName`, `description`, `videoPreviewUrl`, `type` (`admin`\u002F`user`), `isActive`, `createdAt`, `updatedAt`.\n\n---\n\n## Personas (CRUD)\n\nPersonas define target audiences for content plan generation.\n\n- **GET \u002Fpersonas** -- List all. Returns `personas` array + `count`.\n- **POST \u002Fpersonas** -- Create. Body: `name` (required, max 200), `description` (required, max 5000). Returns `id`.\n- **GET \u002Fpersonas\u002F:personaId** -- Get one.\n- **PATCH \u002Fpersonas\u002F:personaId** -- Update. Body: `name`, `description` (both optional).\n- **DELETE \u002Fpersonas\u002F:personaId** -- Delete.\n\n**PersonaResponse**: `_id`, `organizationId`, `name`, `description`, `createdAt`, `updatedAt`.\n\n---\n\n## Messaging (CRUD)\n\nBrand\u002Fpositioning messaging templates.\n\n- **GET \u002Fmessaging** -- List all. Returns `messages` array + `count`.\n- **POST \u002Fmessaging** -- Create. Body: `name` (required, max 200), `body` (required, max 5000). Returns `id`.\n- **GET \u002Fmessaging\u002F:messageId** -- Get one.\n- **PATCH \u002Fmessaging\u002F:messageId** -- Update. Body: `name`, `body` (both optional).\n- **DELETE \u002Fmessaging\u002F:messageId** -- Delete.\n\n**MessagingResponse**: `_id`, `organizationId`, `name`, `body`, `createdAt`, `updatedAt`.\n\n---\n\n## Products (CRUD)\n\nProducts for video generation.\n\n- **GET \u002Fproducts** -- List all. Returns `products` array + `count`.\n- **POST \u002Fproducts** -- Create. Body: `name` (required, max 200), `photos` (required, URL array), `description` (max 1000), `messaging` (max 5000). Returns `id`.\n- **GET \u002Fproducts\u002F:productId** -- Get one.\n- **PATCH \u002Fproducts\u002F:productId** -- Update. Body: `name`, `description`, `photos`, `messaging` (all optional).\n- **DELETE \u002Fproducts\u002F:productId** -- Delete.\n\n**ProductResponse**: `_id`, `name`, `description`, `photos`, `messaging`, `createdAt`, `updatedAt`.\n\n---\n\n## Styles (CRUD)\n\nVideo\u002Fimage creative styles with optional prompt templates.\n\n- **GET \u002Fstyles** -- List all (built-in + custom). Query: `type` (`video`\u002F`image`). Returns `styles` array + `count`.\n- **POST \u002Fstyles** -- Create. Body: `name` (required, max 200), `description` (max 1000), `type` (`video`\u002F`image`), `aspectRatio` (`portrait`\u002F`landscape`\u002F`square`), `promptTemplate` (max 5000, supports `{productName}`, `{messaging}`, `{character}` placeholders). Returns `id`.\n- **GET \u002Fstyles\u002F:styleId** -- Get one.\n- **PATCH \u002Fstyles\u002F:styleId** -- Update. All fields optional.\n- **DELETE \u002Fstyles\u002F:styleId** -- Delete.\n\n**StyleResponse**: `_id`, `name`, `description`, `type`, `aspectRatio`, `styleId`, `promptTemplate`, `isAdmin`, `isStandard`.\n\n---\n\n## Social Scheduling\n\n### GET \u002Fsocial\u002Faccounts\n\nList connected social accounts (max 3 per org). Returns `accounts` array + `count`. Each account: `accountId`, `platform` (`tiktok`\u002F`instagram`\u002F`youtube`), `username`, `displayName`, `profilePicture`, `isActive`.\n\n### POST \u002Fsocial\u002Faccounts\n\nSync connected accounts from the scheduling provider. Returns `{ success: boolean }`.\n\n### DELETE \u002Fsocial\u002Faccounts\u002F:accountId\n\nDisconnect a social account. Returns `{ success: boolean }`.\n\n### POST \u002Fsocial\u002Fposts\n\nSchedule, draft, or immediately publish a video to social media.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `videoUrl` | string | Yes | URL of video to post |\n| `accountIds` | string[] | Yes | Target account IDs |\n| `mode` | string | Yes | `schedule`, `draft`, or `now` |\n| `scheduledFor` | integer | For schedule | Unix timestamp (ms) |\n| `timezone` | string | No | IANA timezone (default: `UTC`) |\n| `content` | string | No | Caption (max 2200 chars) |\n| `videoId` | string | No | RawUGC video ID to link |\n| `publishToInbox` | boolean | No | Send to TikTok Creator Inbox |\n| `tiktokPrivacyLevel` | string | No | `SELF_ONLY`, `PUBLIC_TO_EVERYONE`, `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR` |\n| `tiktokAllowComment` | boolean | No | Allow TikTok comments |\n| `tiktokAllowDuet` | boolean | No | Allow TikTok duets |\n| `tiktokAllowStitch` | boolean | No | Allow TikTok stitches |\n| `tiktokCommercialContentType` | string | No | `none`, `brand_organic`, `brand_content` |\n\n**Response (201)**: SocialPost object.\n\n### GET \u002Fsocial\u002Fposts\n\nList posts. Query: `fromDate` (ms), `toDate` (ms), `includeDrafts` (boolean). Returns `posts` array + `count`.\n\n### GET \u002Fsocial\u002Fposts\u002F:postId\n\nGet a post.\n\n### PATCH \u002Fsocial\u002Fposts\u002F:postId\n\nUpdate a post. Body: `content`, `scheduledFor`, `timezone`, `accountIds` (at least one field required).\n\n### DELETE \u002Fsocial\u002Fposts\u002F:postId\n\nDelete a post. Returns `{ success: boolean }`.\n\n### POST \u002Fsocial\u002Fposts\u002F:postId\u002Freschedule\n\nReschedule a post. Body: `scheduledFor` (required, ms), `timezone`.\n\n### POST \u002Fsocial\u002Fposts\u002F:postId\u002Fpublish\n\nImmediately publish a draft post.\n\n**SocialPost**: `postId`, `platforms`, `status` (`draft`\u002F`scheduled`\u002F`published`\u002F`failed`), `scheduledFor`, `timezone`, `content`, `videoUrl`, `createdAt`, `publishedAt`.\n\n---\n\n## Viral Library\n\n### GET \u002Fviral-library\u002Fvideos\u002F:videoId\n\nGet a viral library video with full AI analysis (hooks, keyframes, performance insights). Returns ViralLibraryVideo.\n\n### GET \u002Fviral-library\u002Fsearch\n\nSemantic search across analyzed videos. Query: `q` (required, natural language), `limit` (1-50, default 20). Returns `results` (array of `{ video, score }`), `query`, `total`.\n\n---\n\n## Research\n\n### POST \u002Fscrape-tiktok\n\nScrape TikTok videos. Costs 3 credits.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `query` | string | Yes | Search keyword, hashtag, or query (max 500) |\n| `mode` | string | No | `keyword`, `hashtag`, `search` (default: `keyword`) |\n| `limit` | integer | No | 1-10 (default: 10) |\n\n**Response (200)**: `scrapeId` (use with content-plans), `count`, `videos` (array with `id`, `url`, `author`, `description`, `stats`, `duration`, `hashtags`, `thumbnail`, `videoUrl`).\n\n### POST \u002Fcontent-plans\n\nGenerate a content plan from scraped videos. Costs 3 credits.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `scrapeId` | string | Yes | From scrape-tiktok response |\n| `brief` | string | Yes | Content plan goals (max 5000) |\n\n**Response (200)**: `planId`, `scrapeId`, `brief`, `topWins`, `gapsToTest`, `blueprints` (array with `category`, `strategy`, `evidence`, `contentIdeas`).\n\n### GET \u002Fcontent-plans\n\nList all content plans. Returns `plans` array + `count`.\n\n### POST \u002Fanalyze-video\n\nAnalyze any video URL (social links or direct URLs). Costs 1 credit. Max 150MB.\n\n| Field | Type | Required | Description |\n|-------|------|----------|-------------|\n| `videoUrl` | string | Yes | Video URL to analyze |\n| `prompt` | string | No | Custom analysis prompt (max 5000) |\n\n**Response (200)**: `summary`, `hook`, `keyframes` (array with `timestamp`, `type`, `description`, `visual`, `audio`, `text`), `durationSeconds`, `tags`, `whyItPerformed`, `attributesToCopy`, `hooksToTest`.\n\n---\n\n## Errors\n\nAll error responses use RFC 7807 Problem Details (JSON): `type`, `title`, `status`, `detail`, `instance`, `errors`.\n\n| Status | Meaning |\n|--------|---------|\n| 400 | Validation error. Surface `detail` and `errors` to user. |\n| 401 | Auth error. Check `RAWUGC_API_KEY`. |\n| 402 | Insufficient credits. Add credits in dashboard. |\n| 403 | Insufficient scope. API key lacks permissions. |\n| 404 | Resource not found. |\n| 429 | Rate limit exceeded. Check `X-RateLimit-Reset` header. |\n| 500 | Server error. Retry or contact support. |\n\n## Rate Limits\n\n- API Key: 10 req\u002Fmin. Session: 20 req\u002Fmin.\n- Headers: `X-RateLimit-Limit`, `X-RateLimit-Remaining`, `X-RateLimit-Reset` (unix timestamp).\n\n## Workflow: Generate then poll\n\n1. **Generate**: POST to the generation endpoint. Note the returned ID (`videoId`\u002F`imageId`\u002F`musicId`).\n2. **Poll**: GET the status endpoint periodically (10-30s). Use exponential backoff.\n3. **Finish**: When `status === 'completed'`, use the result URL. When `failed`, surface error to user.\n4. **Edit** (video only): POST to `\u002Fvideos\u002Fcaptions` or `\u002Fvideos\u002Foverlay`.\n\nFor full request\u002Fresponse shapes, see [reference.md](reference.md).\n",{"name":5,"source":24,"homepage":24,"requires":25,"description":7,"compatibility":28},"https:\u002F\u002Fgithub.com\u002Ftfcbot\u002Frawugc-skills",{"env":26},[27],"RAWUGC_API_KEY","Requires RAWUGC_API_KEY (Bearer token for https:\u002F\u002Frawugc.com\u002Fapi\u002Fv1). Obtain from RawUGC dashboard.","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Ftfcbot\u002Fai-ugc",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":39,"prompt":49,"zipAvailable":50},[40,43,46],{"tool":41,"command":42},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill rawugc-api",{"tool":44,"command":45},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill rawugc-api",{"tool":47,"command":48},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill rawugc-api","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Ftfcbot\u002Fai-ugc\u002FSKILL.md",true,[],[53,61,68,75,82,89],{"skillNo":54,"name":55,"nameZh":6,"description":56,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":57,"categories":58,"keywords":59,"publishedAt":60},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":62,"name":63,"nameZh":6,"description":64,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":65,"categories":66,"keywords":67,"publishedAt":60},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":69,"name":70,"nameZh":6,"description":71,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":60},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":60},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":60},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":60},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]