Skip to content

CLAUDE.md

Latest commit

 

History

History
150 lines (129 loc) · 5.31 KB

CLAUDE.md

File metadata and controls

150 lines (129 loc) · 5.31 KB
Raw

Social Starter Pack

CLI tools for keyword research, content creation, and social media management.

When to Use

Task Tool
Find keyword ideas for content autocomplete
Discover user pain points & opportunities reddit-market-research
Create product demos & screenshots demo-recorder
Publish & manage YouTube Shorts youtube
Post tweets & manage X/Twitter content twitter
Post updates & manage LinkedIn content linkedin
Create & manage Google Forms gforms
Query Search Console data (keywords, clicks) gsc
Upload & manage media assets cloudinary (via MCP)
Spawn Claude Code in new terminals (macOS) spawn-claude
Use all tools via Claude Code mcp-server

Tools

autocomplete-cli

Keyword suggestions from Google, YouTube, Bing, Amazon, DuckDuckGo.

autocomplete google "query"           # Google suggestions
autocomplete youtube "query" --expand # YouTube with a-z expansion
autocomplete amazon "query" --format json

Full docs

demo-recorder

Record demo videos and screenshots of web apps using Playwright.

demo-recorder create my-demo              # Create demo definition
demo-recorder record demo.ts -o video.mp4 # Record video
demo-recorder screenshot demo.ts          # Capture screenshots
demo-recorder gif video.mp4 -o demo.gif   # Convert to GIF

Full docs

youtube-cli

Manage YouTube Shorts - upload, list, clone, update.

youtube auth                                    # First-time auth
youtube upload video.mp4 --title "My Short"    # Upload
youtube list --max 20                          # List videos
youtube clone <video-id> --title "New Title"   # Clone video

Full docs

reddit-market-research

Search Reddit for pain points and market opportunities.

make reddit ARGS='search -s "startups+SaaS" -k "looking for,need help"'
make reddit ARGS='search -s "webdev" -k "bug" --time week --limit 50'

Full docs

twitter-cli

Post tweets and manage content on X/Twitter via API v2.

twitter auth                              # First-time auth with credentials
twitter post "Hello world!"               # Post a tweet
twitter post "Check this!" --image pic.jpg # Post with media
twitter timeline --limit 10               # View recent tweets
twitter thread "First" "Second" "Third"   # Post a thread

Full docs

linkedin-cli

Post updates and manage content on LinkedIn via the Marketing API.

linkedin auth --client-id ID --client-secret SECRET  # First-time auth
linkedin post "Hello LinkedIn!"                       # Post an update
linkedin post "Check this!" --image pic.jpg          # Post with media
linkedin whoami                                       # View current user
linkedin status                                       # Check token status

Full docs

search-console-cli

Query Google Search Console for keywords, pages, clicks, and impressions.

gsc auth                                              # First-time auth
gsc sites                                             # List verified sites
gsc query https://example.com --dimensions query      # Top keywords
gsc query https://example.com --dimensions page       # Top pages
gsc query https://example.com --filter-page "/blog/"  # Filter by page
gsc query https://example.com --days 30 --json        # Last 30 days as JSON

spawn-claude

Spawn Claude Code instances in new Ghostty terminals (macOS only).

spawn-claude                     # New window with yolo
spawn-claude -t                  # New tab
spawn-claude -r                  # Split right
spawn-claude --split-down        # Split down
spawn-claude -p "fix the tests"  # With initial prompt
spawn-claude --safe              # Use claude instead of yolo
spawn-claude -r -c 3             # 3 split-right panes

cloudinary (MCP only)

Upload and manage media assets for social posts. Available via the MCP server.

# Via Claude Code MCP:
cloudinary_upload    # Upload image/video to Cloudinary
cloudinary_list      # List assets by type
cloudinary_search    # Search assets by expression
cloudinary_delete    # Delete an asset
cloudinary_url       # Generate URL with transformations

Full docs

Setup

make install          # Install all CLI tools
make doppler-connect  # Connect to Doppler for secrets
make check            # Verify setup

Claude Code Integration (MCP)

Install the MCP server to use all tools directly from Claude Code:

make install-mcp      # Install MCP server + configure Claude Code
# Restart Claude Code
make uninstall-mcp    # Remove MCP server

Once installed, Claude can:

  • Search keywords (autocomplete)
  • Post to Twitter/LinkedIn
  • Search Reddit for market research
  • Manage YouTube videos
  • Record demos & screenshots
  • Create/manage Google Forms
  • Query Search Console data (gsc)
  • Upload & manage media assets (cloudinary)

Secrets

YouTube, Reddit, Twitter, LinkedIn, and Cloudinary tools require API credentials. Configure via:

  • Doppler: make doppler-connect
  • Or .env file (copy from .env.example)

Cloudinary requires: CLOUDINARY_CLOUD_NAME, CLOUDINARY_API_KEY, CLOUDINARY_API_SECRET