Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Tencent SkillHub ยท Developer Tools
Fanvue
Manage content, chats, subscribers, and earnings on the Fanvue creator platform via OAuth 2.0 API.
skill openclawclawhub Free
Manage content, chats, subscribers, and earnings on the Fanvue creator platform via OAuth 2.0 API.
โฌ 0 downloads โ
0 stars Unverified but indexed
Install for OpenClaw
Quick setup
- Download the package from Yavira.
- Extract the archive and review SKILL.md first.
- Import or place the package into your OpenClaw setup.
Package facts
- Download mode
- Yavira redirect
- Package format
- ZIP package
- Source platform
- Tencent SkillHub
- What's included
- api-reference.md, SKILL.md, examples/chat-operations.ts, examples/auth.ts, examples/post-operations.ts, examples/insights.ts
Validation
- Use the Yavira download entry.
- Review SKILL.md after the package is downloaded.
- Confirm the extracted package contains the expected setup assets.
Install with your agent
Agent handoff
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
- 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.
New install
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
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.
Trust & source
Release facts
- Source
- Tencent SkillHub
- Verification
- Indexed source record
- Version
- 1.0.0
Provenance
- Publisher
- igorls
- Source page
- View original listing
- Canonical URL
- Open canonical page
Documentation
Fanvue API Skill
Integrate with the Fanvue creator platform to manage chats, posts, subscribers, earnings insights, and media content.
1. Create an OAuth Application
Go to the Fanvue Developer Portal Create a new OAuth application Note your Client ID and Client Secret Configure your Redirect URI (e.g., https://your-app.com/callback)
2. Environment Variables
Set these environment variables: FANVUE_CLIENT_ID=your_client_id FANVUE_CLIENT_SECRET=your_client_secret FANVUE_REDIRECT_URI=https://your-app.com/callback
Authentication
Fanvue uses OAuth 2.0 with PKCE (Proof Key for Code Exchange). All API requests require: Authorization Header: Bearer <access_token> API Version Header: X-Fanvue-API-Version: 2025-06-26
OAuth Scopes
Request these scopes based on your needs: ScopeAccessopenidOpenID Connect authenticationoffline_accessRefresh token supportofflineOffline accessread:selfRead authenticated user profileread:chatRead chat conversationswrite:chatSend messages, update chatsread:postRead postswrite:postCreate postsread:creatorRead subscriber/follower dataread:mediaRead media vaultwrite:tracking_linksManage campaign linksread:insightsRead earnings/analytics (creator accounts)read:subscribersRead subscriber lists (creator accounts) Note: Some endpoints (subscribers, insights, earnings) require a creator account and may need additional scopes not listed in the public documentation.
Quick Auth Flow
import { randomBytes, createHash } from 'crypto'; // 1. Generate PKCE parameters const codeVerifier = randomBytes(32).toString('base64url'); const codeChallenge = createHash('sha256') .update(codeVerifier) .digest('base64url'); // 2. Build authorization URL const authUrl = new URL('https://auth.fanvue.com/oauth2/auth'); authUrl.searchParams.set('client_id', process.env.FANVUE_CLIENT_ID); authUrl.searchParams.set('redirect_uri', process.env.FANVUE_REDIRECT_URI); authUrl.searchParams.set('response_type', 'code'); authUrl.searchParams.set('scope', 'openid offline_access read:self read:chat write:chat read:post'); authUrl.searchParams.set('state', randomBytes(32).toString('hex')); authUrl.searchParams.set('code_challenge', codeChallenge); authUrl.searchParams.set('code_challenge_method', 'S256'); // Redirect user to: authUrl.toString() // 3. Exchange authorization code for tokens const tokenResponse = await fetch('https://auth.fanvue.com/oauth2/token', { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ grant_type: 'authorization_code', client_id: process.env.FANVUE_CLIENT_ID, client_secret: process.env.FANVUE_CLIENT_SECRET, code: authorizationCode, redirect_uri: process.env.FANVUE_REDIRECT_URI, code_verifier: codeVerifier, }), }); const tokens = await tokenResponse.json(); // tokens.access_token, tokens.refresh_token
API Base URL
All API requests go to: https://api.fanvue.com
Standard Request Headers
const headers = { 'Authorization': `Bearer ${accessToken}`, 'X-Fanvue-API-Version': '2025-06-26', 'Content-Type': 'application/json', };
Agent Automation
These workflows are designed for AI agents automating Fanvue creator accounts.
Accessing Images (with Signed URLs)
The basic /media endpoint only returns metadata. To get actual viewable URLs, use the variants query parameter: // Step 1: List all media const list = await fetch('https://api.fanvue.com/media', { headers }); const { data } = await list.json(); // Step 2: Get signed URLs for a specific media item const media = await fetch( `https://api.fanvue.com/media/${uuid}?variants=main,thumbnail,blurred`, { headers } ); const { variants } = await media.json(); // variants = [ // { variantType: 'main', url: 'https://media.fanvue.com/private/...' }, // { variantType: 'thumbnail', url: '...' }, // { variantType: 'blurred', url: '...' } // ] Variant Types: main - Full resolution original thumbnail - Optimized preview (smaller) blurred - Censored version for teasers
Creating a Post with Media
// Step 1: Have existing media UUIDs from vault const mediaIds = ['media-uuid-1', 'media-uuid-2']; // Step 2: Create post const response = await fetch('https://api.fanvue.com/posts', { method: 'POST', headers, body: JSON.stringify({ text: 'Check out my new content! ๐ฅ', mediaIds, audience: 'subscribers', // or 'followers-and-subscribers' // Optional: price: null, // Set for pay-per-view publishAt: null, // Set for scheduled posts }), }); Audience Options: ValueWho Can SeesubscribersPaid subscribers onlyfollowers-and-subscribersBoth free followers and subscribers
Sending Messages with Media
// Get subscriber list for decision making const subs = await fetch('https://api.fanvue.com/creators/list-subscribers', { headers }); const { data: subscribers } = await subs.json(); // Get top spenders for VIP targeting const vips = await fetch('https://api.fanvue.com/insights/get-top-spenders', { headers }); const { data: topSpenders } = await vips.json(); // Send personalized message with media await fetch('https://api.fanvue.com/chat-messages', { method: 'POST', headers, body: JSON.stringify({ recipientUuid: subscribers[0].userUuid, content: 'Thanks for being a subscriber! Here\'s something special for you ๐', mediaIds: ['vault-media-uuid'], // Attach media from vault }), }); // Or send to multiple subscribers at once await fetch('https://api.fanvue.com/chat-messages/mass', { method: 'POST', headers, body: JSON.stringify({ recipientUuids: subscribers.map(s => s.userUuid), content: 'New exclusive content just dropped! ๐', mediaIds: ['vault-media-uuid'], }), });
Agent Decision Context
For effective automation, gather this context: interface AutomationContext { // Current media in vault media: { uuid: string; name: string; type: 'image' | 'video'; description: string; // AI-generated caption signedUrl: string; // From variants query }[]; // Audience data subscribers: { uuid: string; name: string; subscribedAt: string; tier: string; }[]; // Engagement signals topSpenders: { uuid: string; totalSpent: number; }[]; // Recent earnings for trend analysis earnings: { period: string; total: number; breakdown: { type: string; amount: number }[]; }; }
Get Current User
const response = await fetch('https://api.fanvue.com/users/me', { headers }); const user = await response.json();
List Chats
const response = await fetch('https://api.fanvue.com/chats', { headers }); const { data, pagination } = await response.json();
Send a Message
const response = await fetch('https://api.fanvue.com/chat-messages', { method: 'POST', headers, body: JSON.stringify({ recipientUuid: 'user-uuid-here', content: 'Hello! Thanks for subscribing!', }), });
Create a Post
const response = await fetch('https://api.fanvue.com/posts', { method: 'POST', headers, body: JSON.stringify({ content: 'New content available!', // Add media IDs, pricing, etc. }), });
Get Earnings
const response = await fetch('https://api.fanvue.com/insights/get-earnings', { headers }); const earnings = await response.json();
List Subscribers
const response = await fetch('https://api.fanvue.com/creators/list-subscribers', { headers }); const { data } = await response.json();
API Reference
See api-reference.md for the complete endpoint documentation.
Token Refresh
Access tokens expire. Use the refresh token to get new ones: const response = await fetch('https://auth.fanvue.com/oauth2/token', { method: 'POST', headers: { 'Content-Type': 'application/x-www-form-urlencoded' }, body: new URLSearchParams({ grant_type: 'refresh_token', client_id: process.env.FANVUE_CLIENT_ID, client_secret: process.env.FANVUE_CLIENT_SECRET, refresh_token: currentRefreshToken, }), }); const newTokens = await response.json();
Error Handling
Common HTTP status codes: StatusMeaning200Success400Bad request - check your parameters401Unauthorized - token expired or invalid403Forbidden - missing required scope404Resource not found429Rate limited - slow down requests
Resources
Fanvue API Documentation OAuth 2.0 Guide Developer Portal Fanvue App Starter Kit
Category context
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Source: Tencent SkillHub
Largest current source with strong distribution and engagement signals.
Package contents
Included in package
4 Scripts2 Docs
- SKILL.md
- api-reference.md
- examples/auth.ts
- examples/chat-operations.ts
- examples/insights.ts
- examples/post-operations.ts