RPC SDK

Python SDK for Browser RPC System.

Installation

pip install rpc-sdk

Or install from source:

cd src/sdk-python
pip install -e .

Quick Start

Basic Usage

from rpc_sdk import RPCClient, RPCAdmin

# Initialize client with node ID
client = RPCClient(
    endpoint='https://rpc-gateway.pub2022.workers.dev',
    node='browser-abc123'
)

# Call platform methods
profile = client.call('douyin.getUserProfile', ['user123'])
print(f"User: {profile['nickname']}, Followers: {profile['followers']}")

# Like a video
result = client.call('douyin.likeVideo', ['video123'])

# Post on Facebook
client.call('facebook.post', ['Hello World!'])

Browser Capabilities

# Get agent info
info = client.agent.getInfo()
print(f"Node: {info['nodeId']}, Type: {info['agentType']}")

# Cookie management
cookies = client.agent.getCookies('douyin.com')
client.agent.setCookies('douyin.com', [
    {'name': 'session', 'value': 'xxx', 'domain': '.douyin.com'}
])
client.agent.clearCookies('douyin.com')

# Tab management
tabs = client.agent.getTabs()
client.agent.openTab('https://douyin.com')
client.agent.switchTab(tabs[0]['id'])

# Screenshot
result = client.agent.screenshot()
# result['dataUrl'] contains base64 PNG

Admin Operations

admin = RPCAdmin(endpoint='https://rpc-gateway.pub2022.workers.dev')

# List all online nodes
nodes = admin.list_nodes()
for node in nodes:
    print(f"{node['nodeId']}: {node['envType']}/{node['agentType']} - {'online' if node['online'] else 'offline'}")

# Filter by environment or service
browser_nodes = admin.list_nodes(env_type='browser')
douyin_nodes = admin.list_nodes(service='douyin')

# Check node status
status = admin.get_node_status('browser-abc123')
print(f"Online: {status['online']}, Last seen: {status['lastSeen']}")

# List available services
services = admin.list_services()
for svc in services:
    print(f"{svc['name']}: {svc['online']}/{svc['total']} nodes online")

# Disconnect a node
admin.delete_node('browser-abc123')

Error Handling

from rpc_sdk import RPCClient, NodeOfflineError, MethodNotFoundError, ExecutionError

client = RPCClient(endpoint='...', node='browser-abc123')

try:
    result = client.call('douyin.sendMessage', ['user123', 'Hello'])
except NodeOfflineError as e:
    print(f"Node {e.node_id} is offline")
except MethodNotFoundError as e:
    print(f"Method {e.method} not found")
except ExecutionError as e:
    print(f"Execution failed: {e.message}")

Custom Timeout

# Global timeout (milliseconds)
client = RPCClient(endpoint='...', node='...', timeout=60000)

# Per-call timeout
result = client.call('douyin.uploadVideo', ['video_path'], timeout=120000)

API Reference

RPCClient

RPCAdmin

License

MIT