Account Binding

Learn how to connect and manage your social media accounts with Browserman using cookies.

Overview

Browserman uses cookies to authenticate with social media platforms on your behalf. This method is secure, reliable, and works with all supported platforms.

Supported Platforms

• Twitter/X - Post tweets, like, retweet, reply, and quote
• Xueqiu (雪球) - Post investment insights and analysis
• Eastmoney (东方财富) - Comment on stock pages
• Tonghuashun (同花顺) - Share market analysis with images

Quick Start

Step 1: Install a Cookie Export Extension

To export cookies from your browser, you'll need a browser extension. We recommend:

Export Cookie JSON File (Recommended)

• Description: Simple and reliable extension to export cookies as JSON files
• Install: Chrome Web Store

StorageAce

• Description: Export and import cookies, localStorage, and sessionStorage with ease
• Install: Chrome Web Store

Step 2: Export Your Cookies

1. Log in to your account on the platform website (e.g., twitter.com, xueqiu.com)
2. Click the extension icon in your browser toolbar
3. Export cookies:
   • Select "Export Cookies" or similar option
   • Choose JSON format
   • Save the file to your computer

Supported formats:

• .json - JSON format (recommended)
• .txt - Plain text JSON format

What are cookies?

Cookies are small pieces of data stored by your browser that help websites remember your login session. Browserman uses these cookies to authenticate with platforms on your behalf, just as if you were using the browser yourself.

Step 3: Upload to Browserman

1. Visit app.browserman.run and sign in
2. Navigate to Accounts page
3. Click Add Account button
4. Fill in the form:
   • Account Name: Give it a descriptive name (e.g., "my-twitter", "work-xueqiu")
   • Platform: Select the platform from dropdown
   • Cookies: Click Upload JSON button and select your exported cookie file
5. Click Create Account

Security Notice

Cookies contain sensitive authentication information. Keep them secure and never share them with others. Your cookies are encrypted and stored securely in the Browserman database.

Detailed Guide

What Are Cookies and Why Do You Need Them?

Cookies are authentication tokens that prove you're logged in to a platform. When you log in to Twitter, for example, the website stores cookies in your browser to remember your session.

Browserman uses these same cookies to:

• Authenticate as your account
• Perform actions on your behalf
• Maintain session state
• Avoid repeated logins

How to Get Cookies

For Twitter/X

1. Go to twitter.com and log in
2. Click your cookie export extension
3. Export cookies as JSON
4. Save the file (e.g., twitter-cookies.json)

For Xueqiu (雪球)

1. Go to xueqiu.com and log in
2. Export cookies using your extension
3. Save as JSON format

For Other Platforms

Same process - log in to the platform, export cookies, save as JSON.

Uploading Cookies in Browserman

Via Dashboard:

1. Go to app.browserman.run/accounts
2. Click Add Account
3. Enter account name (use a descriptive name like "personal-twitter")
4. Select platform from dropdown
5. Click Upload JSON button next to the Cookies field
6. Select your exported cookie file
7. The cookies will be automatically validated and loaded into the text area
8. Click Create Account

Cookie Validation:

Browserman automatically validates your cookies to ensure:

• Valid JSON format
• Required authentication cookies are present
• Cookies are not expired

If validation fails, you'll see an error message explaining what's wrong.

Managing Multiple Accounts

Naming Convention

Use descriptive names for easy identification:

Good Examples:

personal-twitter
work-twitter
brand-official-twitter
xueqiu-trading
eastmoney-analysis

Bad Examples:

account1
test
a
twitter123

Account Organization

You can organize accounts by:

• Purpose: personal, work, brand
• Platform: twitter-main, twitter-backup
• Category: trading-accounts, social-accounts

Switching Between Accounts

When using the API or MCP, specify the account name:

// API Example
{
  "accountName": "personal-twitter",
  "platform": "twitter",
  "tool": "createTweet",
  "parameters": {
    "text": "Hello World!"
  }
}

Account Management

Viewing Accounts

On the Accounts page, you can see:

• Account name
• Platform
• Status (Active, Error, etc.)
• Created date
• Last used date

Editing Accounts

To update an account:

1. Click the Edit button (pencil icon)
2. Update account name or upload new cookies
3. Click Update Account

Deleting Accounts

To remove an account:

1. Click the Delete button (trash icon)
2. Confirm deletion
3. The account and all its data will be permanently removed

Account Status

Active ✅

Account is connected and working properly. Ready to use.

Error ❌

Account has an issue. Common causes:

• Cookies expired
• Account locked or suspended on platform
• Invalid cookies

Solution: Export fresh cookies and update the account.

Troubleshooting

"Invalid JSON format"

Problem: The cookie file is not valid JSON.

Solution:

• Make sure you exported as JSON format (not Netscape or other formats)
• Open the file in a text editor to verify it's valid JSON
• Try a different cookie export extension

"Required cookies missing"

Problem: The cookie file doesn't contain necessary authentication cookies.

Solution:

• Make sure you're logged in before exporting
• Export all cookies, not just specific ones
• Try logging out and back in, then export again

"Cookies expired"

Problem: The cookies are no longer valid.

Solution:

• Log in to the platform again
• Export fresh cookies
• Update your account in Browserman

Account shows "Error" status

Solution:

1. Log in to the platform manually to check account status
2. Export fresh cookies
3. Update the account in Browserman
4. If still failing, the account may be suspended on the platform

Security Best Practices

1. Keep Cookies Secure

• Never share cookie files with anyone
• Delete cookie files from your computer after uploading
• Don't commit cookie files to version control

2. Use Separate Browser Profiles

For better security, use different browser profiles for different accounts:

• Create a Chrome profile for each account
• Export cookies from the correct profile
• Helps prevent accidental mixing of accounts

3. Regularly Update Cookies

Cookies can expire. Update them periodically:

• Set a reminder to update cookies monthly
• Update immediately if you see auth errors
• Always update after changing password on platform

4. Monitor Account Activity

• Regularly check account status in Browserman dashboard
• Review task history for unexpected activity
• Set up alerts for failed tasks

Cookie Format

Browserman accepts cookies in this JSON format:

[
  {
    "name": "auth_token",
    "value": "1234567890abcdef",
    "domain": ".twitter.com",
    "path": "/",
    "expires": 1735689600,
    "httpOnly": true,
    "secure": true,
    "sameSite": "None"
  }
]

Most cookie export extensions automatically format cookies this way.

Rate Limits and Quotas

Each platform has its own limits:

Twitter

• Posts: ~300 tweets per 3 hours
• Likes: ~1000 per day
• Follows: ~400 per day

Xueqiu

• Posts: ~50 per day
• Comments: ~100 per day

Eastmoney

• Comments: ~100 per day

Tonghuashun

• Posts: ~30 per day
• Images: Up to 9 per post

TIP

Browserman automatically manages rate limits to prevent account restrictions. However, be mindful of your usage patterns.

API Integration

Using Accounts via API

List your accounts:

curl https://api.browserman.run/api/accounts \
  -H "Authorization: Bearer YOUR_API_KEY"

Get accounts for specific platform:

curl https://api.browserman.run/api/accounts?platform=twitter \
  -H "Authorization: Bearer YOUR_API_KEY"

Using Accounts via MCP

With MCP configured, ask your AI assistant:

Show me all my connected accounts

Or filter by platform:

Show me all my Twitter accounts

Common Questions

Why cookies instead of OAuth?

Cookies provide:

• Universal support: Works with all platforms, even those without OAuth
• Simple setup: No need to create developer apps
• Full access: Same permissions as your regular browser session
• Reliability: Less likely to be revoked unexpectedly

Are my cookies safe?

Yes:

• Cookies are encrypted at rest in our database
• Transmitted over HTTPS
• Never shared with third parties
• Access controlled by your API key

How long do cookies last?

Typically:

• Twitter: 30-90 days
• Xueqiu: 30 days
• Others: Varies by platform

You'll need to update cookies when they expire.

Can I use the same account on multiple devices?

Yes, but:

• Some platforms may detect unusual activity
• You might get security challenges
• Consider using different accounts for different purposes

What if I change my password?

You'll need to:

1. Log in with new password
2. Export new cookies
3. Update account in Browserman

Need Help?

• Documentation: Getting Started Guide
• Dashboard: Visit app.browserman.run
• API Reference: API Documentation

Next Steps

• Configure MCP Integration
• Explore API Documentation
• View Usage Examples
• Quick Start Guide