{
  "markdown": "# Author Automations Social — Claude Plugin\n\nSchedule social posts, run AI campaigns, and manage your content calendar from Claude Code or Claude Cowork — across **15 platforms** including Instagram (Trial Reels, Stories, feed carousels), TikTok (with auto trending music), Threads (topic chains), YouTube Shorts, Facebook, LinkedIn, X, Pinterest, Reddit, Bluesky, Snapchat, Telegram, Google Business, WhatsApp, and Discord.\n\n## Install\n\nThe plugin ships **skills and slash commands**. The MCP connector itself is added separately because Cowork's plugin-bundled connector flow currently locks the OAuth credential fields, which we can't work around from the plugin manifest. Two short steps:\n\n### Step 1 — Add the connector\n\nIn Cowork (or Claude Desktop): **Settings → Connectors → Add custom connector**\n\n- **Name:** `Author Automations`\n- **Remote MCP server URL:** `https://authorautomations.social/api/mcp`\n- **Advanced settings → OAuth Client ID:** generate at [authorautomations.social/dashboard/settings](https://authorautomations.social/dashboard/settings) → **Claude Connector** card → **Generate credential pair** → copy the value starting with `aacw_`\n- **Advanced settings → OAuth Client Secret:** the value starting with `aacs_` (shown once, copy carefully)\n- Click **Add**.\n\nThe connector authenticates immediately and the `aa_*` tools become available.\n\n### Step 2 — Install the plugin (for skills + slash commands)\n\nIn any Claude Code or Cowork session:\n\n```\n/plugin marketplace add https://github.com/chellehoniker/claude-code-author-automations\n/plugin install author-automations-social@author-automations\n```\n\nThis adds the conversational skills (`pen-names`, `instagram-reels`, `threads-post`, `youtube-video`, `reddit-post`, `tiktok-post`, `linkedin-post`, `aa-setup`, `social-post`, `social-campaign`, `queues`, `guides-author`, `inbox-triage`, `social-analytics`, `boost-post`, `rss-publishing`, `find-something-to-post`, `calendar-notes`, `organize-with-labels`, `comment-to-dm-automation`, `create-meta-ad`) and the `/aa-post` and `/aa-campaign` slash commands. No connector is bundled — Step 1 already covers that.\n\n> Full step-by-step walkthrough with screenshots: **[authorautomations.social/docs/connect](https://authorautomations.social/docs/connect)**.\n\n## Quick start\n\n```\n/aa-post My new cozy mystery is available for pre-order!\n```\n\nOr just describe what you want:\n\n> \"Create a 14-post social media campaign to launch Curses and Currents across Instagram, TikTok, and Facebook\"\n\n> \"Schedule 4 Trial Reels for next week — auto-graduate based on engagement\"\n\n> \"Post to Threads under the Book Threads topic\"\n\nClaude reads your brand guides, writes platform-specific captions, generates media via your chosen AI provider (Pollinations, Magnific, fal.ai, or Google Gemini — set per pen name in Settings → AI; image generation includes a free 12/day tier with no API key needed), and schedules everything to your calendar or queue. You review every post before anything goes live.\n\n**New in 3.12:** book **reference libraries** (save labeled quotes, scenes, and character sketches to a book once — every campaign uses them: real quotes verbatim, never invented), **carousel recipes** (quote & dialogue, POV hooks, trope cards, character reveals — with your real book cover as the closing CTA panel), campaign **objective kinds** and a scene-**variety** dial, per-persona **image style guides**, and regeneration of specific posts even after they're ready.\n\n## What's bundled\n\n| Component | Triggers / Notes |\n|---|---|\n| **301 MCP tools** (served live by the connector) | Publishing, campaigns, queues, and guides at the core (`aa_create_post`, `aa_create_campaign`, queue + guide CRUD), plus the full 2026 surface: unified inbox (DMs, comments incl. likes + private replies, reviews, automation flows), analytics (engagement, best-time, follower growth, content decay, per-platform deep dives), Media Studio (standalone image/video/audio generation with a 12/day included image tier), the unified All-Ads dashboard + Creative Studio + Amazon Ads (ads upgrade), CRM (contacts, broadcasts, sequences), Google Business Profile suite, WhatsApp suite (templates, flows, groups, numbers), account groups, per-platform validators, link shortening, and publish logs. Tool definitions update server-side — no plugin reinstall needed. Full reference at [/docs/api](https://authorautomations.social/docs/api) |\n| **Skills** (markdown chat guides) | `aa-setup`, `pen-names` (switch between author identities), `social-post`, `social-campaign`, `instagram-reels` (Trial Reels + covers), `threads-post` (topic tags + chains), `youtube-video` (titles + Shorts), `reddit-post` (subreddit + flair), `tiktok-post` (drafts, brand-partner disclosure, AI attestation), `linkedin-post` (the firstComment URL trick, PDF document posts), `queues` (per-platform + per-persona scheduling), `guides-author` (chat-edit personas + content guides), `inbox-triage` (DMs, comments, reviews — STOS), `social-analytics` (performance + best-time — STOS), `boost-post` (paid promotion with spend gates — STOS), `rss-publishing` (auto-post from blog/feed), `find-something-to-post` (idea picker from books + feeds), `calendar-notes` (date annotations on the calendar), `organize-with-labels` (tag + filter posts), `comment-to-dm-automation` (auto-DM commenters — STOS), `create-meta-ad` (build a fresh Meta ad from scratch — STOS) |\n| **Slash commands** | `/aa-post <topic>`, `/aa-campaign <objective>` |\n\nThe skills make Claude fluent in platform-specific options. Saying \"schedule 8 trial reels\" auto-routes through the `instagram-reels` skill which knows the right `instagramOptions.trialParams` shape.\n\n## Authentication\n\nAuthentication is on the **connector** (added in Step 1 of Install), not the plugin. You paste a Client ID + Client Secret pair you generate from your Author Automations Social dashboard into the connector's Advanced settings; Cowork runs the OAuth `client_credentials` grant against our token endpoint, mints a Bearer JWT, and uses it on every MCP request.\n\nLost the Secret? Generate a new pair from [Settings → Claude Connector](https://authorautomations.social/dashboard/settings), then update the connector in Cowork: Settings → Connectors → click the connector → paste the new credentials → Save. The old pair stays revocable from the same Settings card.\n\nIf you have multiple pen names, your connector exposes every pen name you have access to. Switch between them by saying *\"post under my [pen name]\"* or *\"switch to [pen name]\"* — the bundled `pen-names` skill teaches Claude how to discover your pen names and route subsequent calls. See `skills/pen-names/SKILL.md`.\n\n## Updating\n\n### Claude Cowork\n\nSettings → Plugins → three-dot menu next to the marketplace → toggle **Sync automatically** ON. Updates flow as we ship them. To force a check, click **Check for updates**.\n\n### Claude Code (CLI)\n\n```\n/plugin update author-automations-social@author-automations\n```\n\n## Requirements\n\n- An active [Author Automations Social](https://authorautomations.social) subscription ($29/month or $290/year)\n- At least one connected social media account\n- Modern browser (for the OAuth authorize step)\n- **Ads features** (boost, standalone ads, unified ads dashboard, Creative Studio, Amazon Ads) require the **ads upgrade — $20/month**, included in every StorytellerOS plan\n\n## Support\n\n- **Connect guide:** [authorautomations.social/docs/connect](https://authorautomations.social/docs/connect) — install + credentials + troubleshooting\n- API reference: [authorautomations.social/docs/api](https://authorautomations.social/docs/api)\n- Email: support@authorautomations.com\n- Bugs / feature requests: [open an issue](https://github.com/chellehoniker/claude-code-author-automations/issues)\n\n## What's new\n\n### v3.12.0 (2026-09-05) — synced to the 301-tool MCP surface\n\nThe hosted MCP grew to **301 tools**. New in this sync: the wizard-era campaign shape (post counts instead of day slots, per-platform options, recipe-guided carousels with the real-cover closer), the book reference library (`aa_*` tools for labeled reference docs — quotes, scenes, character notes — that ground campaign generation), media folders and asset management (`aa_list_media_folders`, `aa_create_media_folder`, `aa_delete_media_folder`, `aa_update_studio_asset`, `aa_delete_studio_asset`), and video-studio provenance on campaign media. Tool definitions load server-side, so existing installs pick all of this up with no reinstall.\n\n### v3.11.0 (2026-07-27) — synced to the 281-tool MCP surface\n\nThe hosted MCP server grew from ~92 to **281 tools** since the last release (upstream contract parity + the unified ads/creative wave — all live in prod; the connector picks tool definitions up automatically). This release syncs the plugin's skills and docs to that surface:\n\n- **Entitlement model** — ads tools (boost, standalone ads, unified dashboard, Creative Studio, Amazon) now require the **ads upgrade: $20/month, purchasable from the dashboard, included in every STOS plan**. `boost-post` and `create-meta-ad` updated from the old \"STOS-only\" framing. Inbox and analytics remain STOS-plan features; inbox automation **flows** are free on every plan.\n- **`boost-post`** — boosting now covers Meta, TikTok, LinkedIn, Google, and Pinterest (minimums: TikTok $20/day, Pinterest $5); ChatGPT + Amazon are reporting-only. Documents the `targeting` vs `rawTargeting` mutual exclusion and `aa_search_ad_targeting` for geo lookups.\n- **`create-meta-ad`** — Creative Studio flow (`aa_generate_ad_copy` → `aa_generate_ad_creative` / `aa_generate_ad_video`, `aa_draft_ad_campaign` reviewable drafts, carousels), `aa_create_lead_form` for the Leads objective, and per-network notes for TikTok/LinkedIn/Google/Pinterest standalone ads + `aa_create_amazon_campaign`.\n- **`inbox-triage`** — comment likes (`aa_like_inbox_comment`), public-comment→private-DM replies (`aa_private_reply_inbox_comment`), conversation archiving, message edit/delete/react (per-platform support noted), and automation flows (`aa_create_flow` / `aa_activate_flow` / `aa_get_flow_runs`).\n- **`social-analytics`** — follower growth, content decay, posting frequency, Instagram demographics, LinkedIn aggregate/per-post, YouTube daily views, per-post timelines, and the all-networks ads view (`aa_list_all_ads` / `aa_get_ads_timeline`).\n- **Media generation** — `aa_generate_media` now takes per-run `imageProvider` / `videoProvider` / `musicProvider` (+ model) overrides; provider settings are a preference, not a gate — **Pollinations images run on an included 12/day tier with no API key**. `social-post` and `instagram-reels` now route standalone generation through the Media Studio (`aa_studio_generate_media`).\n- **`social-post`** — `aa_get_next_queue_slot` for \"when would the queue publish this?\", root-level YouTube `tags`, Discord platform options, and `aa_shorten_link` (link shortening is now a chat tool; the v3.10.1 \"dashboard-only\" note is superseded — setup still lives in Settings → AI).\n- **`social-campaign`** — checks `aa_list_campaign_drafts` for stalled campaigns before creating new ones.\n\n### v3.10.1 (2026-05-29)\n\nDocuments the Link Shortener. `social-post`, `social-campaign`, and `guides-author` now note that branded short domains and auto-shorten (for campaigns and templates) are configured in the dashboard's **Settings → AI** and applied automatically server-side — there's no chat tool for it, so agents point users to the dashboard instead of trying to shorten links from chat.\n\n### v3.10.0 — Nine new user-facing skills\n\nCloses the gap between the MCP tool surface and what users can ask for in chat. Five high-frequency flows (Tier 1) plus four niche-but-useful ones (Tier 2):\n\n**Tier 1 — most-requested workflows:**\n\n- `inbox-triage` — read DMs, comments, and reviews across all connected accounts. Draft replies in the user's voice (via `aa_get_guides`), show, and send only after explicit confirmation. Hide spam only on explicit user OK. STOS-only.\n- `social-analytics` — performance review across a date range (default last 7 days), top + bottom performers, per-platform breakdown, and best-time-to-post recommendations from `aa_get_best_time`. Hands off to `boost-post` when the user wants to amplify a winner. STOS-only.\n- `boost-post` — paid promotion of an already-published post on Meta ad accounts. Two non-negotiable gates: explicit post pick, then a verbatim \"type 'go' to confirm\" gate after showing computed total spend (daily × duration). Defaults to PAUSED state when the user is uncertain. STOS-only.\n- `rss-publishing` — subscribe a blog/feed so new items become posts. Auto-post defaults to OFF (items land as drafts). Immediate post-create poll surfaces recent items so the user sees it's working.\n- `find-something-to-post` — idea picker that pulls candidates from the user's books library and subscribed RSS feeds via `aa_find_content`. Presents 5 options, then hands off to `social-post` for drafting and scheduling.\n\n**Tier 2 — niche but useful:**\n\n- `calendar-notes` — add a date annotation (launch milestone, reminder, placeholder) to the calendar without scheduling an actual post. Pen-name scoped.\n- `organize-with-labels` — tag, filter, and bulk-organize posts. Knows the PUT-replaces-full-set foot-gun on `aa_set_post_labels` and prescribes read-then-union when adding to an existing label set. Pen-name scoped.\n- `comment-to-dm-automation` — set up Meta's auto-DM-on-comment rules. Defaults to PAUSED on create; explicit user enable required. STOS-only.\n- `create-meta-ad` — build a fresh Meta ad from scratch (5-step wizard: Objective → Creative → Audience → Budget → Review). Full bid-strategy matrix; defaults to PAUSED state with a \"type 'go'\" total-spend confirm. Cross-references `boost-post` if the user actually wants to promote an existing post. STOS-only.\n\n### v3.9.1 (2026-05-23)\n\n- **Pen-name correctness for the campaign + post lifecycle.** Six MCP tools (`aa_save_campaign_plan`, `aa_generate_media`, `aa_check_media_status`, `aa_schedule_campaign`, `aa_update_post`, `aa_delete_post`) previously had no `profileId` parameter, so calls against campaigns or posts on a non-primary pen name silently scoped to the user's primary profile and 404'd \"Campaign not found\" / \"Post not found.\" Server side: each route already gated correctly on the stored profile id, so there was zero cross-tenant write — the failure was fail-safe, not a tenancy leak. Now every campaign-lifecycle and post-lifecycle tool accepts `profileId`; the `pen-names` skill lists all 13 profile-scoped tools and the `social-campaign` skill threads `profileId` through every step of the build sequence.\n\n### v3.9.0 (2026-05-14)\n\n- **Two new specialist skills** matching the per-platform option expansion that landed in social-standalone today:\n  - `tiktok-post` — TikTok drafts (Creator Inbox), the `commercialContentType` + paired-brand-flag contract (brand_organic/brand_content rejection if you forget the pair), AI-generated-video attestation, content-preview + express-consent policy fields. Trigger on \"tiktok draft,\" \"paid partnership,\" \"ai generated video,\" \"duet/stitch.\"\n  - `linkedin-post` — The first-comment URL trick (LinkedIn down-ranks caption-URLs 40–50%, comments are exempt — put the link in `firstComment` and end the caption with \"Link in the comments 👇\"). PDF document posts with `documentTitle`. Link-preview suppression.\n- **Orchestrator updates** — `social-post` now routes TikTok and LinkedIn requests to the new specialists, and folds in three single-field controls inline: Facebook `draft` (Publishing Tools), Twitter `longVideo` (X Premium amplify_video), Pinterest `link` (destination URL per pin).\n- **Campaign-level platform options** documented in `social-campaign`: TikTok draft + commercial content + long description, Facebook draft + firstComment + Reel title, Instagram/LinkedIn/YouTube firstComment, Twitter longVideo, Pinterest link. Apply once at the campaign level instead of per-post.\n\n### v3.7.1 (2026-05-08)\n\n- `guides-author` skill: question library re-organized as **facets, not guides**. Each underlying question is asked ONCE and the answer is compiled into every guide section it informs (voice → 5 sections across 3 guides; off-limits → 3 sections; etc.). Skill is transparent about which guides each answer lands in. All four guides still get written — none of them are skipped — because the dashboard's AI generator reads each separately. The previous structure asked the same things multiple times across the 4-guide questionnaire; this is a clean dedup.\n\n### v3.7.0 (2026-05-08)\n\n- **Queue CRUD via chat** — new `aa_create_queue`, `aa_update_queue`, `aa_delete_queue`, `aa_list_queues` tools and a `queues` skill. Queues now scope per-platform AND per-persona: a queue can serve only specific networks (`platforms[]`) and/or only one persona under the pen name (`tag` matching `aa_list_guide_sets`). The campaign scheduler prefers persona-scoped queues for that campaign's posts, falling back to shared queues.\n- **Guides + personas chat-edit** — new `aa_update_guide`, `aa_rename_guide_set`, `aa_delete_guide_set` tools and a `guides-author` skill that walks the user through editing existing guides (\"show me the diff before applying\") and creating new personas in stages (brand → prose → copywriting → social media). The skill knows the question library used by the dashboard's guide-generation flow so it asks the same things in the same order.\n- Migration 044 adds `persona_tag` to `aa_queue_platforms` (NULL = shared, non-NULL = persona-scoped).\n\n### v3.6.0 (2026-05-08)\n\n- **Carousel slide configs** in `social-campaign` — per-slide prompts and per-slide text overlays via `slideConfigs` on the day plan. Lossy back-compat with `imagePrompts` (string array) preserved.\n- **Per-day generator overrides** — set `providerOverrides.{image,video,music}` on any day to use a different model than the campaign or pen-name default. Lets authors rescue a wedged provider day without changing the campaign-wide setting.\n- **Multi-provider media gen** — `aa_generate_media` routes per task type to Magnific, fal.ai, or Google Gemini per the resolution chain (per-day → per-campaign → pen-name default). Per-post `last_error` captures specific failure reasons (rate-limit, expired key, unsupported model).\n- **Skip-day + upload-your-own** — skill now mentions both affordances so Claude knows to suggest them when a day's gen fails or the user has their own asset.\n- **Brand sweep** — replaced \"Freepik\" with the multi-provider naming across `social-post`, `social-campaign`, `instagram-reels`, `youtube-video`, README. The plugin no longer hard-references one image provider in any user-facing copy.\n\n### v3.3.0 (2026-05-01)\n\n- **Connector unbundled.** The plugin no longer ships a `.mcp.json`. Cowork's plugin-bundled connectors lock the OAuth Client ID/Secret fields, and `userConfig` doesn't unlock them for HTTP MCP servers. Splitting the connector out into a manual \"Add custom connector\" step (which keeps those fields editable) is the cleaner mental model and gets users unblocked. Plugin still ships every skill and slash command — credentials live on the connector, not the plugin.\n\n### v3.2.0 (2026-05-01) — superseded\n\n- Tried to declare Client ID + Client Secret as required `userConfig`. The fields appeared but didn't unlock the connector dialog's OAuth slots. Removed in v3.3.\n\n### v3.1.0\n\n- `pen-names` skill: switch between author identities mid-conversation. Multi-pen-name users now see all their pen names exposed; previously the plugin defaulted to the primary.\n\n### v3.0.0\n\n- Moved tools from a local MCP server to the hosted one at `authorautomations.social/api/mcp`. No more Node, bun-compiled binary, or SessionStart hook.\n- Works identically on Cowork (any OS) and Claude Code CLI.\n\n### Migration from v3.0–v3.2\n\nIf you previously installed v3.0–v3.2, you may have a half-broken auto-installed connector with locked credentials. Clean up:\n\n1. Settings → Connectors → find the auto-installed `author-automations` connector → **Remove**.\n2. Settings → Connectors → **Add custom connector** with the URL + credentials from the Install section above.\n3. The plugin keeps working as-is — its skills and slash commands don't change.\n\n## License\n\nMIT\n",
  "bytes": 20329,
  "sha": "9d92333e921863b05b6f5123aaef7d7e8145ec05eea85c5cfcc80602849d73bd",
  "repo_slug": "chellehoniker/claude-code-author-automations",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_chellehoniker_claude_code_author_automat_c5e65b8e/readme"
}