convez.ai
SkillAutomaçãoAvançado
vanities

Social Skills — Automação de Redes Sociais via Browser

vanities/social-skills

Automação social sem APIs: markdown skills + Chrome real + agent-browser

Ver no GitHub
InicialPluginScore · de 0 a 100

Skill de automação multiplataforma (Instagram, LinkedIn, X, Pinterest, TikTok) que funciona através de um navegador Chrome real, sem APIs oficiais. Usa Claude Code OAuth-autenticado + agent-browser, com workflows markdown + bash, ideal para rotinas de publicação e gerenciamento de conteúdo social.

Instalação

$npx convez-ai vanities/social-skills

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
7
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Publicar conteúdo automatizado em múltiplas redes sociais via cron
  • Gerenciar múltiplas contas de marca com persistência de sessão
  • Orquestrar fluxos de conteúdo (fan-out diário) via skills compostas

Veredito

Solução técnica robusta para quem rejeita APIs oficiais e precisa de automação browser-native em redes sociais. Exige setup local avançado (macOS, Claude Code CLI, agent-browser) e credenciais diretas, mas oferece controle total sem limitações de rate-limit de API. Bem documentada, com suporte a workflows cron compostos.

README

A tradução para o português deste README ainda está na fila.

social-skills

because I'm terrible at being social.

Skill-driven social media automation. The agent (Claude Code today, OAuth-authed) does the work; this repo provides the playbook.

┌────────────────────────────────────────────────────────────┐
│  Trigger: cron / interactive slash command                 │
│                       │                                    │
│                       ▼                                    │
│  Skill (skills/<name>/SKILL.md; .claude/skills symlink)    │
│       │  reads platform docs (docs/platforms/*.md)         │
│       ▼                                                    │
│  Agent (Claude Code, OAuth-authed — no API key)            │
│       │  drives                                            │
│       ▼                                                    │
│  agent-browser CLI  →  real Chrome (persistent profile)    │
│       ▼                                                    │
│  Instagram / LinkedIn / X / Pinterest                      │
└────────────────────────────────────────────────────────────┘

Hard rules (set during the build, do not relitigate):

  • No platform APIs (no Meta Graph, no X API, no instagrapi). Everything goes through a real browser.
  • No Python framework. Just markdown skills + small bash scripts.
  • No ANTHROPIC_API_KEY. Claude Code (OAuth via your subscription) IS the agent.
  • Real Chrome only — Chrome for Testing crashes on routine UI like the profile picker.
  • One persistent shared browser. Each platform = one tab. Skills find existing tabs and switch into them; they never close them.

Prerequisites

  • macOS (iOS-simulator screenshots use xcrun simctl)
  • Claude Code CLI, OAuth-authed
  • agent-browser CLI on PATH
  • jq and ImageMagick (brew install jq imagemagick)

Setup

# 1. Clone + cd in
git clone <your-fork-of-social-skills>
cd social-skills

# 2. Add credentials (only the platforms you'll use)
cp .env.example .env
# Edit .env: INSTAGRAM_*_USERNAME / _PASSWORD, LINKEDIN_*, TWITTER_*, PINTEREST_*

# 3. Configure your brand — handles, company id, topic filters
cp config/brand.example.json config/brand.json
# Edit brand.json. See PERSONAL.md for the multi-brand pattern.

# 4. Launch the persistent shared browser
bash scripts/launch_browser.sh

# 5. Log in to each platform once (state persists)
claude  # then in chat: /instagram-login <account>, /linkedin-login, /x-login, /pinterest-login

That's it. Skills do the rest. For composite cron-driven skills (like a daily-content fan-out), see PERSONAL.md — those are templated in personal.example/ and copied per brand.

Skills

Login + post

SkillStatus
/instagram-login <account> · /instagram-post <account> <media...> <caption>✅
/linkedin-login · /linkedin-post <personal|<company-id>> <media...> <caption>✅ Personal feed or company-page. Multi-image carousels supported.
/x-login · /x-post <handle> <thread-json>✅ Single tweet or multi-tweet reply chain (X's in-modal threads don't accept programmatic uploads to the 2nd+ tweet). Handle is REQUIRED — switches the X session before composing.
/pinterest-login · /pinterest-post <pin-json>✅ Tall iPhone screenshots fit Pinterest natively (no padding). Creates boards inline.
/tiktok-post🚫 Deferred — TikTok web upload is video-only (Photo Mode is mobile-app exclusive). See skills/tiktok-post/SKILL.md for unblock paths.

Composite + orchestration

SkillWhat it does
/feature-post <description> [brand-slug] [platforms]End-to-end feature launch. Drives the iOS sim via XcodeBuildMCP, captures screenshots, pads, drafts platform-specific captions (announcement-style for LinkedIn / IG / X; search-rewritten how-to for Pinterest), gets your approval, then cross-posts to enabled platforms. Reads handles + brand voice from config/brand.json.
Daily-content compositeA cron-driven daily fan-out skill is templated in personal.example/skills/post-daily-content/ — copy to skills/post-daily-<brand>/ (gitignored; visible to Claude through .claude/skills) and customize. See PERSONAL.md.

Engagement / warming

Pure-broadcast accounts get throttled. These skills mimic organic behavior — scroll, like, save, repost — to graduate fresh accounts and keep reach healthy.

SkillWhat it does
/x-warm [brand]Scroll feed + 1–3 likes + maybe 1 repost. Filters likes via topic_filter_regex from brand.json so the warming stays on-brand.
/pinterest-warm [brand]Scroll feed + 1–4 saves + 1–2 reacts + maybe 1 follow. Same topic filter as X.
/instagram-warm [brand]Scroll feed + 1–3 likes. No follow / comment — IG punishes those signals hardest.
/warm-allPicks the most-stale eligible platform per invocation and runs its warm skill (using default_brand). Cron-fired 3× daily at staggered minutes.

Hard rules baked into every warm skill:

  • No auto-comments anywhere — highest bot-detection signal.
  • No auto-follow on X / IG for fresh accounts; Pinterest follow is allowed but rare.
  • All actions wait 4–18s jitter between each, refs are re-snapshotted before every click.

Daily action budgets, weights, and time windows live in config/engagement-schedule.json. Per-platform state (last run, today's counters) in ~/.social-skills/state/engagement-state.json.

Cron — installed automation

# Daily content fan-out: noon local, posts to your enabled platforms.
# scripts/daily_content.sh is templated in personal.example/scripts/ — copy
# it (it's gitignored) and tailor for your brand. See PERSONAL.md.
0 12 * * * /bin/bash <repo>/scripts/daily_content.sh

# Engagement warming: 3 staggered slots, picks one platform per fire
17  9 * * * /bin/bash <repo>/scripts/warm_all_cron.sh
43 13 * * * /bin/bash <repo>/scripts/warm_all_cron.sh
22 18 * * * /bin/bash <repo>/scripts/warm_all_cron.sh

Both wrappers invoke claude --print --dangerously-skip-permissions "/<skill>" because cron can't approve interactive permission prompts.

Operational caveats:

  • The Mac must be awake at fire times (cron doesn't wake the machine).
  • The persistent Chrome window must be open with all platform tabs logged in. Run bash scripts/launch_browser.sh after a reboot.

Helper scripts

ScriptWhat
scripts/launch_browser.shBoots the persistent shared Chrome against ~/.social-skills/chrome-profile/ with the anti-detection flag.
scripts/jitter.sh MIN MAXRandom delay generator — used between every browser action.
scripts/pad_ios_screenshot.sh <input> [output] [mode]Pads tall iPhone screenshots to 4:5. Plain modes: edge (seamless sample), blur (Apple-style frame), random (palette), #RRGGBB (solid). Fancy modes include gradient, bloom, sparkle, cosmic, divine, holy, lovely, mother, father, dream, ascii-art, shadow, lament, easter, christmas, pentecost. Smart: surprise picks a lighter fancy mode at random.
scripts/ascii_devotional_video.sh <screenshot.png> [output.mp4] [theme] [reference]Builds a short 9:16 h264 MP4 with animated ASCII-video-style background behind a devotional screenshot. Pair with pad_ios_screenshot.sh ... ascii-art for the static ASCII-art-style image route.
scripts/warm_all_cron.shWarming cron entrypoint — cd into the repo, restore PATH, guard the shared Chrome's health, run Claude headless.
scripts/daily_content.shDaily-content cron entrypoint (template in personal.example/scripts/, gitignored once installed). Same guard pattern, calls your composite skill.

Logs

LogSource
~/.social-skills/logs/cron/<date>.logDaily content cron (shell + headless Claude stdout)
~/.social-skills/logs/cron/warm-<date>.logWarm cron
~/.social-skills/logs/login/<platform>-<account>-<ts>.jsonPer-login form-field discovery (the breadcrumb that makes UI changes easy to chase)
~/.social-skills/logs/post/<platform>-<account>-<ts>.jsonPer-post outcome + verification screenshot path
~/.social-skills/logs/warm/<platform>-<account>-<ts>.jsonPer-warm-pass actions executed
~/.config/agent-browser/<platform>-<account>.jsonSaved browser session (cookies, localStorage, etc.)

Layout

social-skills/
├── README.md
├── AGENTS.md                          ← universal agent playbook (PII-free)
├── CLAUDE.md -> AGENTS.md             ← Claude Code compatibility symlink
├── CLAUDE.local.md.example            ← Claude Code personal addendum template (handles, live state, voice)
├── PERSONAL.md                        ← how the personal/.example pattern works
├── .env.example
├── config/
│   ├── brand.example.json             ← multi-brand schema (handles, IDs, topic filters)
│   ├── engagement-schedule.json       ← warming cadence (active hours, daily budgets, weights)
│   └── comment-corpus.json            ← universal warm-comment phrases (curate per brand)
├── docs/
│   ├── architecture.md
│   └── platforms/<name>.md            ← reusable per-platform playbooks
├── scripts/
│   ├── launch_browser.sh
│   ├── jitter.sh
│   ├── pad_ios_screenshot.sh
│   ├── ascii_devotional_video.sh
│   ├── pad_ios_video.sh
│   ├── type_human.sh
│   ├── x_switch_account.sh
│   ├── find_platform_tab.sh
│   ├── switch_to_platform_tab.sh
│   └── warm_all_cron.sh
├── skills/                             ← universal skill source of truth
│   ├── instagram-{login,post,warm}/SKILL.md
│   ├── linkedin-{login,post}/SKILL.md
│   ├── x-{login,post,warm,article}/SKILL.md
│   ├── pinterest-{login,post,warm}/SKILL.md
│   ├── reddit-post/SKILL.md           ← stub
│   ├── tiktok-post/SKILL.md           ← stub, deferred
│   ├── feature-post/SKILL.md
│   └── warm-all/SKILL.md
├── .claude/
│   └── skills -> ../skills             ← Claude Code compatibility symlink
└── personal.example/                  ← templates for brand-flavored composite skills
    ├── README.md
    ├── comment-corpus.brand.json      ← sample domain-specific comment phrases
    ├── scripts/
    │   ├── daily_content.sh           ← sample cron entrypoint
    │   └── devotional_video*.sh       ← sample brand-specific helpers
    └── skills/
        └── post-daily-content/SKILL.md

Adding a platform

  1. Write docs/platforms/<name>.md — URLs, login flow, anti-bot notes.
  2. Add skills skills/<name>-login/SKILL.md, <name>-post/SKILL.md, optionally <name>-warm/SKILL.md. Claude Code sees them through .claude/skills -> ../skills. Mirror the x-* skills as a template — they cover the trickiest cases (graduated-access, reply-chain threads, viewport-required clicks).
  3. Update config/engagement-schedule.json with the platform's action budget.
  4. Wire into /warm-all and your daily-content composite (in skills/post-daily-<brand>/) if you want it cron-scheduled.

Status

  • Instagram — login, post (incl. multi-image carousel), warm
  • LinkedIn — login (incl. PIN checkpoint), post (personal + company pages)
  • X / Twitter — login, post (incl. reply-chain threads), warm
  • Pinterest — login, post (incl. inline board creation), warm
  • Daily-content composite — sample skill in personal.example/, fans to IG + X + Pinterest, cron-driven
  • /feature-post — XcodeBuildMCP-driven multi-platform feature launch
  • Engagement warming — /warm-all cron with 3 staggered slots, per-platform action budgets
  • iOS screenshot padding — edge / blur / random / hex modes
  • TikTok — deferred until a video pipeline exists (animated screenshots + voiceover)
  • YouTube Shorts — same blocker as TikTok
  • Facebook Page — easiest path is creating a Page + linking to IG via Meta Accounts Center to enable the cross-post toggle
  • Bluesky — similar to X minus the friction; ~1 hr to mirror the X skills
  • Auto-comment generation with user-approval pattern (currently fully skipped — too high-risk)

License

GNU General Public License v3.0

Ver o original no GitHub

Bom para

Relacionados