N8N Tools - Weibo Enhanced

Complete Weibo social platform integration with 55+ operations covering the full Weibo ecosystem. This N8N community node provides comprehensive access to Posts, Comments, Users, Trends, Messages, and Analytics APIs specifically designed for the Chinese market and Weibo's unique social features.

✨ Features

• 📝 Posts & Weibo: Create, publish, and manage weibo posts with rich media support
• 💬 Comments & Interactions: Handle comments, likes, reposts, and social interactions
• 👤 Users & Profiles: Manage user profiles, followers, and following relationships
• 🔥 Trends & Hot Topics: Access trending topics, hashtags, and viral content
• 📩 Direct Messages: Send and manage private messages between users
• 📊 Analytics & Insights: Track engagement metrics, audience data, and performance analytics
• 🔍 Search & Discovery: Advanced search for users, posts, and trending content
• 🏷️ Tags & Hashtags: Manage hashtags, topics, and content categorization
• 📱 Timeline Management: Access user timelines, home feeds, and public timelines
• 🎯 Advertising & Promotion: Create and manage promotional content and ads
• 🔒 Secure API: Powered by N8N Tools platform with usage tracking and validation

🚀 Quick Start

Installation

Install this node in your N8N instance:

Via Community Nodes (Recommended)

1. Go to Settings > Community Nodes in your N8N interface
2. Click Install a community node
3. Enter n8n-nodes-n8ntools-weibo
4. Click Install

Via npm

npm install n8n-nodes-n8ntools-weibo

Setup Credentials

1. Sign up at N8N Tools and get your API key
2. In N8N, create new N8N Tools API credentials
3. Enter your API URL: https://api.n8ntools.io
4. Enter your API key

📋 Available Resources

📝 Posts & Weibo (8 Operations)

Complete weibo post management:

Operation	Description	Features
Create Post	Publish new weibo posts	Text, images, videos, location
Update Post	Modify existing posts	Content editing, media updates
Delete Post	Remove weibo posts	Soft delete with restoration
Get Post	Retrieve specific post details	Engagement metrics, comments
Get User Timeline	Fetch user's posted weibos	Pagination, date filtering
Get Home Timeline	Access user's home feed	Following users' content
Repost Weibo	Share posts with comments	Attribution, custom messages
Get Public Timeline	Access public weibo feed	Trending and popular content

💬 Comments & Interactions (7 Operations)

Social interaction management:

• Create Comment: Add comments to weibo posts
• Reply to Comment: Respond to existing comments
• Delete Comment: Remove comments from posts
• Get Comments: Retrieve post comments with pagination
• Like Post: Add likes to weibo posts
• Unlike Post: Remove likes from posts
• Get Likes: Retrieve users who liked posts

👤 Users & Profiles (6 Operations)

User profile and relationship management:

• Get User Info: Retrieve detailed user profiles
• Update Profile: Modify user profile information
• Follow User: Follow other Weibo users
• Unfollow User: Unfollow users
• Get Followers: List user's followers
• Get Following: List users being followed

🔥 Trends & Hot Topics (5 Operations)

Trending content and topic management:

• Get Trending Topics: Retrieve current hot topics
• Get Topic Posts: Fetch posts under specific topics
• Search Trends: Find trending hashtags and keywords
• Get Hot Searches: Access popular search terms
• Get Topic Statistics: Analytics for trending topics

📩 Direct Messages (4 Operations)

Private messaging capabilities:

• Send Message: Send direct messages to users
• Get Messages: Retrieve message conversations
• Get Conversation: Access specific conversation threads
• Delete Message: Remove messages from conversations

📊 Analytics & Insights (5 Operations)

Performance tracking and analytics:

• Get Post Analytics: Detailed post performance metrics
• Get User Analytics: User engagement and growth stats
• Get Audience Demographics: Follower demographic data
• Get Engagement Metrics: Interaction analytics
• Get Reach Statistics: Content reach and impressions

🔍 Search & Discovery (6 Operations)

Advanced search and content discovery:

• Search Users: Find users by keywords and criteria
• Search Posts: Search weibo posts by content
• Search Topics: Find hashtags and trending topics
• Advanced Search: Multi-criteria search with filters
• Get Suggestions: User and content recommendations
• Search by Location: Location-based content discovery

🏷️ Tags & Hashtags (4 Operations)

Content categorization and hashtag management:

• Create Hashtag: Create new hashtag topics
• Get Hashtag Info: Retrieve hashtag statistics
• Follow Topic: Subscribe to hashtag updates
• Get Topic Timeline: Posts under specific hashtags

📱 Timeline Management (3 Operations)

Feed and timeline customization:

• Get Mentions: Retrieve posts mentioning the user
• Get Favorites: Access saved/favorited posts
• Manage Lists: Create and manage user lists

🎯 Advertising (7 Operations)

Promotional content and advertising:

• Create Promoted Post: Promote weibo posts
• Get Ad Performance: Advertising campaign analytics
• Target Audience: Define promotional targeting
• Manage Campaigns: Campaign lifecycle management
• Get Ad Statistics: Detailed advertising metrics
• Create Ad Account: Set up advertising accounts
• Budget Management: Control advertising spend

💡 Usage Examples

Create Engaging Weibo Post

// Configuration
Resource: "Posts & Weibo"
Operation: "Create Post"
Request Body: {
  "status": "🎉 今天是个美好的一天！分享一些生活中的小确幸 ✨\n\n#生活日记 #美好时光 #正能量 \n\n📍 北京·朝阳区",
  "pic": "https://example.com/image.jpg",
  "lat": 39.9042,
  "long": 116.4074,
  "annotations": [{
    "client_ip": "192.168.1.1",
    "place_id": "B2094754D6E1C0BDF4"
  }],
  "rip": "192.168.1.1"
}

// Output
{
  "resource": "posts",
  "operation": "createPost",
  "success": true,
  "id": "4567890123456789",
  "mid": "4567890123456789",
  "created_at": "Mon Jan 15 10:30:00 +0800 2024",
  "text": "🎉 今天是个美好的一天！...",
  "reposts_count": 0,
  "comments_count": 0,
  "attitudes_count": 0,
  "creditsUsed": 1,
  "creditsRemaining": 99
}

Manage Comments and Interactions

// Configuration
Resource: "Comments & Interactions"
Operation: "Create Comment"
Request Body: {
  "id": "4567890123456789",
  "comment": "非常赞同你的观点！👍 这样的正能量内容值得更多人看到 #支持",
  "comment_ori": 0,
  "rip": "192.168.1.1"
}

// Like a post
Resource: "Comments & Interactions"
Operation: "Like Post"
Request Body: {
  "id": "4567890123456789",
  "attitude": "heart"
}

// Get post comments
Resource: "Comments & Interactions"
Operation: "Get Comments"
Request Body: {
  "id": "4567890123456789",
  "count": 50,
  "page": 1,
  "filter_by_author": 0
}

Track Trending Topics

// Configuration
Resource: "Trends & Hot Topics"
Operation: "Get Trending Topics"
Request Body: {
  "count": 20,
  "base_app": 0
}

// Get posts under specific topic
Resource: "Trends & Hot Topics"
Operation: "Get Topic Posts"
Request Body: {
  "q": "春节",
  "count": 20,
  "page": 1,
  "feature": 0,
  "is_pic": 0,
  "is_video": 0
}

Advanced User Search

// Configuration
Resource: "Search & Discovery"
Operation: "Search Users"
Request Body: {
  "q": "科技博主",
  "count": 10,
  "page": 1,
  "sort": "default",
  "region": "custom:11:1000",
  "gender": "all",
  "school": "",
  "company": ""
}

// Location-based search
Resource: "Search & Discovery"
Operation: "Search by Location"
Request Body: {
  "lat": 39.9042,
  "long": 116.4074,
  "range": 1000,
  "count": 20,
  "sort": 0,
  "start_time": 1704067200,
  "end_time": 1704153600
}

Analytics and Performance Tracking

// Configuration
Resource: "Analytics & Insights"
Operation: "Get Post Analytics"
Request Body: {
  "ids": "4567890123456789,4567890123456790",
  "period": "7d"
}

// Get audience demographics
Resource: "Analytics & Insights"
Operation: "Get Audience Demographics"
Request Body: {
  "uid": "1234567890",
  "period": "30d",
  "metrics": ["age", "gender", "location", "interests"]
}

Direct Messaging

// Configuration
Resource: "Direct Messages"
Operation: "Send Message"
Request Body: {
  "uid": "1234567890",
  "text": "你好！看到你在微博上分享的内容很有意思，想和你交流一下 😊",
  "media": "",
  "type": 0
}

// Get conversation
Resource: "Direct Messages"
Operation: "Get Conversation"
Request Body: {
  "uid": "1234567890",
  "count": 20,
  "max_id": 0,
  "since_id": 0
}

⚙️ Configuration Options

Environment Settings

• Access Token: Weibo application access token
• App Key: Weibo application key
• App Secret: Weibo application secret
• API Version: Weibo API version

Post Options

• Location Data: GPS coordinates and place information
• Media Attachments: Images, videos, and other media
• Hashtags: Topic tags and categorization
• Mention Users: @user mentions in posts

Advanced Features

• Emoji Support: Full Unicode emoji support
• Rich Text: Formatted text with links and mentions
• Geo-targeting: Location-based content and search
• Multi-media: Support for various media formats

🛠️ Example Workflows

Social Media Management

[Content Creation] → [Weibo Enhanced: Create Post] → [Monitor Engagement] → [Respond to Comments] → [Analytics Review]

Trend Monitoring

[Weibo Enhanced: Get Trending Topics] → [Analyze Trends] → [Create Relevant Content] → [Track Performance]

Customer Engagement

[Mention Monitoring] → [Weibo Enhanced: Get Mentions] → [Respond to Users] → [Track Sentiment] → [Report Insights]

Influencer Outreach

[Search Influencers] → [Weibo Enhanced: Search Users] → [Analyze Profiles] → [Send Messages] → [Track Responses]

📊 Comparison with Official Weibo Node

Feature Category	Official Node	Weibo Enhanced	Improvement
Posts & Weibo	1 operation	8 operations	+700%
Comments	0 operations	7 operations	∞ (new)
Users & Profiles	1 operation	6 operations	+500%
Trends	0 operations	5 operations	∞ (new)
Direct Messages	0 operations	4 operations	∞ (new)
Analytics	0 operations	5 operations	∞ (new)
Search	0 operations	6 operations	∞ (new)
Tags & Hashtags	0 operations	4 operations	∞ (new)
Timeline	0 operations	3 operations	∞ (new)
Advertising	0 operations	7 operations	∞ (new)
Total Operations	2 operations	55 operations	+2650%

🔧 API Endpoints

All operations are routed through N8N Tools API for consistent authentication and usage tracking:

Resource	Base Endpoint
Posts & Weibo	/api/v1/weibo/posts/
Comments & Interactions	/api/v1/weibo/comments/
Users & Profiles	/api/v1/weibo/users/
Trends & Hot Topics	/api/v1/weibo/trends/
Direct Messages	/api/v1/weibo/messages/
Analytics & Insights	/api/v1/weibo/analytics/
Search & Discovery	/api/v1/weibo/search/
Tags & Hashtags	/api/v1/weibo/tags/
Timeline Management	/api/v1/weibo/timeline/
Advertising	/api/v1/weibo/advertising/

🚨 Error Handling

The node provides comprehensive error handling with detailed messages:

{
  "error": "INSUFFICIENT_USER_PERMISSIONS",
  "success": false,
  "resource": "posts",
  "operation": "createPost",
  "details": {
    "issue": "User does not have permission to post",
    "field": "access_token",
    "code": 10014,
    "weibo_error_code": 10014
  }
}

💸 Pricing & Limits

• Standard Operations: 1 credit per API call
• Media Upload Operations: 2 credits (images, videos)
• Search Operations: 1 credit per query
• Monthly Quotas: Based on your N8N Tools subscription plan
• Rate Limits: 10 requests/minute (based on Weibo API limits)
• Usage Tracking: Real-time credit monitoring

🔧 Troubleshooting

Common Issues

Authentication Errors

• Verify N8N Tools API key is valid and active
• Check API URL is set to https://api.n8ntools.io
• Ensure Weibo access token has required permissions

Content Policy Violations

• Check content against Weibo community guidelines
• Ensure no prohibited keywords or content
• Verify media files meet format requirements

Chinese Text Encoding

• Use proper UTF-8 encoding for Chinese characters
• Ensure emoji and special characters are supported
• Check text length limits for posts and comments

Rate Limiting

• Implement delays between requests
• Use batch operations where possible
• Monitor Weibo API rate limits

📈 Performance Tips

1. Content Optimization: Use trending hashtags and topics
2. Timing: Post during peak user activity hours
3. Engagement: Respond promptly to comments and mentions
4. Analytics: Regular monitoring for optimization opportunities
5. Chinese Localization: Use appropriate language and cultural references

🆘 Support

• Documentation: docs.n8ntools.io
• API Reference: api.n8ntools.io/docs
• Community: Discord
• Email: support@n8ntools.io

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

Made with ❤️ by N8N Tools