Quick Start

This guide shows common operations with Socialia.

Posting Content

Python API:

from socialia import Twitter, LinkedIn

# Post to Twitter
twitter = Twitter()
result = twitter.post("Hello World!")
print(f"Posted: {result['url']}")

# Post with image
media = twitter.upload_media("photo.jpg")
twitter.post("Check this!", media_ids=[media["media_id"]])

# Post thread
twitter.post_thread([
    "Thread starts here...",
    "Second tweet in thread",
    "Final tweet!"
])

CLI:

# Basic post
socialia post twitter "Hello World!"

# Post with image
socialia post twitter "Check this!" --image photo.jpg

# Post from file
socialia post twitter --file content.txt

# Dry run (preview without posting)
socialia post twitter "Test" --dry-run

Scheduling Posts

# Schedule for specific time today
socialia post twitter "Morning!" --schedule "09:00"

# Schedule for specific date/time
socialia post twitter "Hello!" --schedule "2026-02-14 10:00"

# Relative scheduling
socialia post twitter "Soon!" --schedule "+1h"
socialia post twitter "Later!" --schedule "+30m"

# View scheduled posts
socialia schedule list

# Start scheduler daemon
socialia schedule daemon

Reading Your Feed

# Get recent posts from all platforms
socialia feed

# Get detailed feed with full text
socialia feed --detail

# Get mentions/notifications
socialia feed --mentions

# Get replies to your posts
socialia feed --replies

# Platform-specific
socialia feed twitter --limit 10

Analytics

Python API:

from socialia import GoogleAnalytics

ga = GoogleAnalytics()

# Track event
ga.track_event("button_click", {"button": "subscribe"})

# Get realtime users
realtime = ga.get_realtime_users()

# Get page views
views = ga.get_page_views(start_date="7daysAgo")

CLI:

# Track event
socialia analytics track page_view --param page /docs

# Get realtime users
socialia analytics realtime

# Get page views
socialia analytics pageviews --start 7daysAgo

# Get traffic sources
socialia analytics sources

MCP Server for AI Agents

Start the MCP server:

socialia mcp start

List available tools:

socialia mcp list-tools -v

Check server health:

socialia mcp doctor

Show Claude Desktop configuration:

socialia mcp installation