sbusso/claudeclaw/x-integration

Name: x-integration
Author: sbusso

Claude Code and agent skill by sbusso/claudeclaw

Trust tier 3

community
ext:[{"type":"config","description":"Configuration overrides"}]

Source check pending

Checking that the SKILL.md file is still in the repository.

X (Twitter) integration for ClaudeClaw. Post tweets, like, reply, retweet, and quote. Use for setup, testing, or troubleshooting X functionality. Triggers on "setup x", "x integration", "twitter", "post tweet", "tweet".

Install

npx vskill@latest install sbusso/claudeclaw/x-integration

Semi-extensibleMentions customization, but needs skill-specific knowledge. Read the extensible skills standard

SKILL.md

X (Twitter) Integration

Browser automation for X interactions via WhatsApp.

Compatibility: ClaudeClaw v1.0.0. Directory structure may change in future versions.

Features

Action	Tool	Description
Post	`x_post`	Publish new tweets
Like	`x_like`	Like any tweet
Reply	`x_reply`	Reply to tweets
Retweet	`x_retweet`	Retweet without comment
Quote	`x_quote`	Quote tweet with comment

Prerequisites

Before using this skill, ensure:

ClaudeClaw is installed and running - WhatsApp connected, service active
Dependencies installed:

``bash npm ls playwright dotenv-cli || npm install playwright dotenv-cli ``

CHROME_PATH configured in .env (if Chrome is not at default location):

``bash # Find your Chrome path mdfind "kMDItemCFBundleIdentifier == 'com.google.Chrome'" 2>/dev/null | head -1 # Add to .env CHROME_PATH=/path/to/Google Chrome.app/Contents/MacOS/Google Chrome ``

Service name: Derived from the directory name: com.claudeclaw.<dirname> (macOS) / claudeclaw-<dirname> (Linux). For example, if cwd is my-assistant, the service is com.claudeclaw.my-assistant. Determine the correct service name before running service commands below.

Quick Start

bash

# 1. Setup authentication (interactive)
npx dotenv -e .env -- npx tsx .claude/skills/x-integration/scripts/setup.ts
# Verify: data/x-auth.json should exist after successful login
 
# 2. Rebuild container to include skill
./src/runtimes/docker/build.sh
# Verify: Output shows "COPY .claude/skills/x-integration/agent.ts"
 
# 3. Rebuild host and restart service
# Service name: In developer mode use com.claudeclaw / claudeclaw.
# Service name derived from directory name: com.claudeclaw.<dirname> / claudeclaw-<dirname>.
npm run build
launchctl kickstart -k gui/$(id -u)/com.claudeclaw  # macOS
# Linux: systemctl --user restart claudeclaw
# Verify: launchctl list | grep claudeclaw (macOS) or systemctl --user status claudeclaw (Linux)

Configuration

Environment Variables

Variable	Default	Description
`CHROME_PATH`	`/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`	Chrome executable path
`CLAUDECLAW_ROOT`	`process.cwd()`	Project root directory
`LOG_LEVEL`	`info`	Logging level (debug, info, warn, error)

Set in .env file (loaded via dotenv-cli at runtime):

bash

# .env
CHROME_PATH=/Applications/Google Chrome.app/Contents/MacOS/Google Chrome

Configuration File

Edit lib/config.ts to modify defaults:

typescript

export const config = {
    // Browser viewport
    viewport: { width: 1280, height: 800 },
    // Timeouts (milliseconds)
    timeouts: {
        navigation: 30000,    // Page navigation
        elementWait: 5000,    // Wait for element
        afterClick: 1000,     // Delay after click
        afterFill: 1000,      // Delay after form fill
        afterSubmit: 3000,    // Delay after submit
        pageLoad: 3000,       // Initial page load
    },
    // Tweet limits
    limits: {
        tweetMaxLength: 280,
    },
};

Data Directories

Paths relative to project root:

Path	Purpose	Git
`data/x-browser-profile/`	Chrome profile with X session	Ignored
`data/x-auth.json`	Auth state marker	Ignored
`logs/claudeclaw.log`	Service logs (contains X operation logs)	Ignored

Architecture

┌─────────────────────────────────────────────────────────────┐
│  Container (Linux VM)                                       │
│  └── agent.ts → MCP tool definitions (x_post, etc.)    │
│      └── Writes IPC request to /workspace/ipc/tasks/       │
└──────────────────────┬──────────────────────────────────────┘
                       │ IPC (file system)
                       ▼
┌─────────────────────────────────────────────────────────────┐
│  Host (macOS)                                               │
│  └── src/orchestrator/ipc.ts → processTaskIpc()                         │
│      └── host.ts → handleXIpc()                         │
│          └── spawn subprocess → scripts/*.ts               │
│              └── Playwright → Chrome → X Website           │
└─────────────────────────────────────────────────────────────┘

Why This Design?

API is expensive - X official API requires paid subscription ($100+/month) for posting
Bot browsers get blocked - X detects and bans headless browsers and common automation fingerprints
Must use user's real browser - Reuses the user's actual Chrome on Host with real browser fingerprint to avoid detection
One-time authorization - User logs in manually once, session persists in Chrome profile for future use

File Structure

.claude/skills/x-integration/
├── SKILL.md          # This documentation
├── host.ts           # Host-side IPC handler
├── agent.ts          # Container-side MCP tool definitions
├── lib/
│   ├── config.ts     # Centralized configuration
│   └── browser.ts    # Playwright utilities
└── scripts/
    ├── setup.ts      # Interactive login
    ├── post.ts       # Post tweet
    ├── like.ts       # Like tweet
    ├── reply.ts      # Reply to tweet
    ├── retweet.ts    # Retweet
    └── quote.ts      # Quote tweet

Integration Points

To integrate this skill into ClaudeClaw, make the following modifications:

1. Host side: `src/orchestrator/ipc.ts`

Add import after other local imports:

typescript

import { handleXIpc } from '../.claude/skills/x-integration/host.js';

Modify processTaskIpc function's switch statement default case:

typescript

// Find:
default:
logger.warn({ type: data.type }, 'Unknown IPC task type');
// Replace with:
default:
const handled = await handleXIpc(data, sourceGroup, isMain, DATA_DIR);
if (!handled) {
    logger.warn({ type: data.type }, 'Unknown IPC task type');
}

2. Container side: `agent/runner/src/ipc-mcp.ts`

Add import after cron-parser import:

typescript

// @ts-ignore - Copied during Docker build from .claude/skills/x-integration/
import { createXTools } from './skills/x-integration/agent.js';

Add to the end of tools array (before the closing ]):

typescript

    ...createXTools({ groupFolder, isMain })

3. Build script: `src/runtimes/docker/build.sh`

Change build context from src/runtimes/docker/ to project root (required to access .claude/skills/):

bash

# Find:
docker build -t "${IMAGE_NAME}:${TAG}" .
 
# Replace with:
cd "$SCRIPT_DIR/.."
docker build -t "${IMAGE_NAME}:${TAG}" -f src/runtimes/docker/Dockerfile .

4. Dockerfile: `src/runtimes/docker/Dockerfile`

First, update the build context paths (required to access .claude/skills/ from project root):

dockerfile

# Find:
COPY agent-runner/package*.json ./
...
COPY agent-runner/ ./
 
# Replace with:
COPY agent/runner/package*.json ./
...
COPY agent/runner/ ./

Then add COPY line after COPY agent/runner/ ./ and before RUN npm run build:

dockerfile

# Copy skill MCP tools
COPY .claude/skills/x-integration/agent.ts ./src/skills/x-integration/

Setup

All paths below are relative to project root (CLAUDECLAW_ROOT).

1. Check Chrome Path

bash

# Check if Chrome exists at configured path
cat .env | grep CHROME_PATH
ls -la "$(grep CHROME_PATH .env | cut -d= -f2)" 2>/dev/null || \
echo "Chrome not found - update CHROME_PATH in .env"

2. Run Authentication

bash

npx dotenv -e .env -- npx tsx .claude/skills/x-integration/scripts/setup.ts

This opens Chrome for manual X login. Session saved to data/x-browser-profile/.

Verify success:

bash

cat data/x-auth.json  # Should show {"authenticated": true, ...}

3. Rebuild Container

bash

./src/runtimes/docker/build.sh

Verify success:

bash

./src/runtimes/docker/build.sh 2>&1 | grep -i "agent.ts"  # Should show COPY line

4. Restart Service

bash

npm run build
launchctl kickstart -k gui/$(id -u)/com.claudeclaw  # macOS
# Linux: systemctl --user restart claudeclaw

Verify success:

bash

launchctl list | grep claudeclaw  # macOS — should show PID and exit code 0 or -
# Linux: systemctl --user status claudeclaw

Usage via WhatsApp

Replace @Assistant with your configured trigger name (ASSISTANT_NAME in .env):

@Assistant post a tweet: Hello world!
 
@Assistant like this tweet https://x.com/user/status/123
 
@Assistant reply to https://x.com/user/status/123 with: Great post!
 
@Assistant retweet https://x.com/user/status/123
 
@Assistant quote https://x.com/user/status/123 with comment: Interesting

Note: Only the main group can use X tools. Other groups will receive an error.

Testing

Scripts require environment variables from .env. Use dotenv-cli to load them:

Check Authentication Status

bash

# Check if auth file exists and is valid
cat data/x-auth.json 2>/dev/null && echo "Auth configured" || echo "Auth not configured"
 
# Check if browser profile exists
ls -la data/x-browser-profile/ 2>/dev/null | head -5

Re-authenticate (if expired)

bash

npx dotenv -e .env -- npx tsx .claude/skills/x-integration/scripts/setup.ts

Test Post (will actually post)

bash

echo '{"content":"Test tweet - please ignore"}' | npx dotenv -e .env -- npx tsx .claude/skills/x-integration/scripts/post.ts

Test Like

bash

echo '{"tweetUrl":"https://x.com/user/status/123"}' | npx dotenv -e .env -- npx tsx .claude/skills/x-integration/scripts/like.ts

Or export CHROME_PATH manually before running:

bash

export CHROME_PATH="/path/to/chrome"
echo '{"content":"Test"}' | npx tsx .claude/skills/x-integration/scripts/post.ts

Troubleshooting

Authentication Expired

bash

npx dotenv -e .env -- npx tsx .claude/skills/x-integration/scripts/setup.ts
launchctl kickstart -k gui/$(id -u)/com.claudeclaw  # macOS
# Linux: systemctl --user restart claudeclaw

Browser Lock Files

If Chrome fails to launch:

bash

rm -f data/x-browser-profile/SingletonLock
rm -f data/x-browser-profile/SingletonSocket
rm -f data/x-browser-profile/SingletonCookie

Check Logs

bash

# Host logs (relative to project root)
grep -i "x_post\|x_like\|x_reply\|handleXIpc" logs/claudeclaw.log | tail -20
 
# Script errors
grep -i "error\|failed" logs/claudeclaw.log | tail -20

Script Timeout

Default timeout is 2 minutes (120s). Increase in host.ts:

typescript

const timer = setTimeout(() => {
  proc.kill('SIGTERM');
  resolve({ success: false, message: 'Script timed out (120s)' });
}, 120000);  // ← Increase this value

X UI Selector Changes

If X updates their UI, selectors in scripts may break. Current selectors:

Element	Selector
Tweet input	`[data-testid="tweetTextarea_0"]`
Post button	`[data-testid="tweetButtonInline"]`
Reply button	`[data-testid="reply"]`
Like	`[data-testid="like"]`
Unlike	`[data-testid="unlike"]`
Retweet	`[data-testid="retweet"]`
Unretweet	`[data-testid="unretweet"]`
Confirm retweet	`[data-testid="retweetConfirm"]`
Modal dialog	`[role="dialog"][aria-modal="true"]`
Modal submit	`[data-testid="tweetButton"]`

Container Build Issues

If MCP tools not found in container:

bash

# Verify build copies skill
./src/runtimes/docker/build.sh 2>&1 | grep -i skill
 
# Check container has the file
docker run claudeclaw-agent ls -la /app/src/skills/

Security

data/x-browser-profile/ - Contains X session cookies (in .gitignore)
data/x-auth.json - Auth state marker (in .gitignore)
Only main group can use X tools (enforced in agent.ts and host.ts)
Scripts run as subprocesses with limited environment

Security

Security scanPassed, 90 of 100Pattern checks on the skill's files.
Model reviewPassed

See the full security report

Quality evaluation

Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

SKILL.md in the repositoryCheckingskills/x-integration/SKILL.md

Popularity

Repository stars: 173
Repository forks: 56
7-day trend score: 26

Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.

Extension points

configConfiguration overrides

Learn the extensible skills standard

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

Claude Code
Cursor
GitHub Copilot
Windsurf
Codex
Gemini CLI
Cline
Amp
Roo Code
Goose
Continue
Kilo Code
Junie
Trae
OpenHands
Qwen Code
AI Agent
Tabnine Chat
Sourcegraph Cody
Amazon Q
Firebase Genkit
Sweep
Devin
Phind
Mentat
Claude Desktop
Aider
GPT Pilot
Plandex
bolt.new
v0
Replit Agent
Anse
TypingMind
BetterChatGPT
LibreChat
Warp AI
Pieces
Fig AI

Embed badge

[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/sbusso/claudeclaw/x-integration/badge)](https://verified-skill.com/skills/sbusso/claudeclaw/x-integration)

Something wrong with this skill or its page? Tell us.