{
  "markdown": "# GooseWorks\n\nPut your AI agent on the growth team. GooseWorks gives Claude Code, Cursor, and Codex specialist skills for research, lead generation, social data, ads, product photography, graphics, and growth work—with one install.\n\n## Install\n\nPick your agent:\n\n```bash\n# Claude Code\nnpx gooseworks install --claude --mcp\nnpx gooseworks install --claude --mcp --with goose-graphics\n\n# Cursor\nnpx gooseworks install --cursor --mcp\n\n# Codex\nnpx gooseworks install --codex --mcp\n\n# All detected agents\nnpx gooseworks install --all\n```\n\nThis does three things:\n1. Opens browser for Google sign-in\n2. Installs the GooseWorks skill into your coding agent\n3. You're ready — ask your agent to \"scrape reddit\", \"find leads\", \"research competitors\", or \"create product photos\"\n\nNew to GooseWorks? Ask for the work you want done, for example:\n\n```text\n/gooseworks research my competitors\n```\n\nYour first request automatically starts or resumes the same onboarding used by the GooseWorks web app. It covers your company, coworker, creative taste, first campaign, growth stage, research review, and channels, saving after every step. The resulting **Company Brain** is shared across web, Claude, Codex, ChatGPT, and Cowork; when setup is complete, the agent immediately continues the request you originally made.\n\nUse `--with <skill-slug>` to install standalone GooseWorks skills alongside the main GooseWorks skill. For example, `--with goose-graphics` installs `/goose-graphics` locally so your agent can run it directly without doing a catalog lookup through `/gooseworks`.\n\n### Other install methods\n\n```bash\n# Via Vercel skills.sh\nnpx skills add gooseworks-ai/gooseworks\n\n# Via Claude Code plugins\n/plugin install gooseworks\n\n# Via OpenClaw ClawHub\nclawhub skill install gooseworks\n\n# Via Codex (OpenAI) — available once merged into openai/skills\ncodex skills install gooseworks\n```\n\n## Commands\n\n### `install`\n\nFull setup: login + install skill + configure your coding agent.\n\n```bash\nnpx gooseworks install --claude    # Configure for Claude Code\nnpx gooseworks install --cursor    # Configure for Cursor\nnpx gooseworks install --codex     # Configure for Codex\nnpx gooseworks install --all       # Configure all detected agents\nnpx gooseworks install --claude --with goose-graphics\nnpx gooseworks install --claude --with goose-graphics --with aeo\nnpx gooseworks install --all --ref <campaign-or-referral-code>\n```\n\n**What it does:**\n- Runs `login` if you don't have credentials yet\n- Writes the GooseWorks skill to `~/.agents/skills/gooseworks/SKILL.md`\n- Downloads any `--with` standalone skills from `gooseworks-ai/goose-skills` into `~/.agents/skills/<slug>/`\n- Creates symlinks in `~/.claude/skills/` (Claude) or `~/.codex/skills/` (Codex), or writes MCP config (Cursor)\n\n`--with` is repeatable. Unknown slugs are reported clearly and do not block the main GooseWorks skill install.\n\n### `login`\n\nAuthenticate with GooseWorks via Google OAuth.\n\n```bash\nnpx gooseworks login\n```\n\n**Flow:**\n1. Starts a temporary HTTP server on a random local port\n2. Opens your browser to the GooseWorks sign-in page\n3. You sign in with Google\n4. Token saved to `~/.gooseworks/credentials.json`\n\nTimeout: 120 seconds. If the browser doesn't complete, re-run the command.\n\n### `logout`\n\nClear saved credentials.\n\n```bash\nnpx gooseworks logout\n```\n\nDeletes `~/.gooseworks/credentials.json`.\n\n### `whoami`\n\nShow which account you're currently signed in as. Handy when you have multiple\nGooseWorks accounts and need to confirm the active one before running a command.\nReads local credentials only — no network call.\n\n```bash\nnpx gooseworks whoami\nnpx gooseworks whoami --json    # machine-readable output\n```\n\nOutput:\n```\nSigned in as you@example.com\nScope:      user\nAgent:      2e32bd49-…\nAPI base:   https://api.gooseworks.ai\n```\n\nTo switch accounts, run `gooseworks logout` then `gooseworks login`.\n\n> The GooseWorks MCP server exposes the same identity check as the `whoami` tool\n> (email + the exact agent/org the token is pinned to), separate from\n> `list_accessible_scopes`, which lists *every* workspace you can reach.\n\n### `search`\n\nSearch the GooseWorks skill catalog.\n\n```bash\nnpx gooseworks search \"reddit scraping\"\nnpx gooseworks search \"find emails\"\nnpx gooseworks search \"competitor research\"\n```\n\n### `credits`\n\nCheck your credit balance.\n\n```bash\nnpx gooseworks credits\n```\n\nOutput:\n```\nCredits: 847 available (500 subscription + 347 purchased)\n```\n\n### `update`\n\nRe-fetch the latest skill without re-authenticating.\n\n```bash\nnpx gooseworks update\n```\n\n## How It Works\n\n1. **Install** — authenticates you and installs a master skill file into your coding agent\n2. **Ask your agent anything** — \"scrape r/ClaudeAI\", \"find CTOs at AI startups\", \"research competitor pricing\"\n3. **Agent finds the right skill** — searches the GooseWorks catalog of 100+ skills\n4. **Runs it** — downloads and executes the skill's Python scripts, which call GooseWorks APIs\n5. **You get results** — structured data returned directly in your coding agent\n\nStandalone skills installed with `--with` skip the catalog search step. After `npx gooseworks install --claude --with goose-graphics`, you can invoke `/goose-graphics ...` directly from Claude Code.\n\n## What growth teams can ask\n\nUse `/gooseworks` naturally. It can bring in specialist capabilities without requiring you to know the internal skill name:\n\n```text\n/gooseworks Analyze the ads my three competitors are currently running.\n/gooseworks Mine these TikTok and Instagram comments for objections and buying intent.\n/gooseworks Find skincare creators whose audiences match women aged 25–40 in the US.\n/gooseworks Diagnose our Meta performance and recommend the next creative test.\n/gooseworks Research demand for this new product idea.\n```\n\nFor focused creative work you can also use:\n\n- `/goose-ads` for static ads, ad research, and ad performance.\n- `/goose-product-photos` for studio, lifestyle, marketplace, social, and on-model product photography.\n- `/goose-video` for supported video-ad formats.\n- `goose-graphics` for social graphics, carousels, slides, and branded visual content.\n- `animate-image` to turn an approved still into a short motion creative.\n\nConsumer and ecommerce brands are one important use case. The same `/gooseworks` coworker remains useful for B2B teams, agencies, sales, research, lead generation, and other GTM work.\n\n## Direct provider calls\n\n### `call`\n\nCall managed data providers without buying a separate provider key. ScrapeCreators uses its first-party GooseWorks proxy and defaults to GET:\n\n```bash\nnpx gooseworks call scrapecreators /v2/instagram/post/comments \\\n  --query='{\"url\":\"https://www.instagram.com/p/POST_ID/\"}'\n```\n\nFor the few official ScrapeCreators POST operations, pass the method and JSON body explicitly:\n\n```bash\nnpx gooseworks call scrapecreators /v1/facebook/adLibrary/search/ads \\\n  --method POST \\\n  --body='{\"query\":\"running shoes\",\"country\":\"US\"}'\n```\n\n## Security & data handling\n\nWe'd rather you know exactly what this CLI does before you run it:\n\n- **Skill scripts are open source and fetched at runtime.** `gooseworks fetch <slug>` (and the skills that call it) download skill content and Python scripts from the GooseWorks catalog on demand, save them under `/tmp/gooseworks-scripts/`, and run them on your machine. Every skill and its scripts live in the public, open-source [goose-skills repo](https://github.com/gooseworks-ai/goose-skills/tree/main/skills) — the catalog is synced from there — so the code is the same maintained, auditable source you can read on GitHub. They're served from the catalog (kept current) rather than pinned to the installed CLI version, so you always get the latest version of a skill.\n- **The MCP server is opt-in.** It's only registered when you pass `--mcp` (or `--all`). When you do, the CLI adds a `gooseworks` entry to `~/.claude.json` (Claude Code) or `~/.codex/config.toml` (Codex) that includes your bearer token in an `Authorization` header — this is how every HTTP MCP server authenticates. Skip `--mcp` if you don't want the server registered as a live tool provider; shared onboarding and ads creation require it.\n- **Credentials are stored locally.** Your API key lives in `~/.gooseworks/credentials.json`, written with `0600` permissions in a `0700` directory. `gooseworks logout` deletes it.\n- **`gooseworks env` exposes your key.** `eval $(gooseworks env)` exports `GOOSEWORKS_API_KEY` into your shell environment, where any process you run can read it. Most commands (e.g. `gooseworks call`) load credentials on their own — only use `env` when a script genuinely needs the environment variable.\n- **No install hooks.** `npm install` only downloads files; nothing executes on install. The CLI has four dependencies (chalk, commander, open, ora), uses standard OAuth with CSRF protection, and makes all network calls over HTTPS.\n\nSource for the CLI and skills lives at [github.com/gooseworks-ai/gooseworks](https://github.com/gooseworks-ai/gooseworks).\n\n## What's Included\n\n100+ skills across these categories:\n\n| Category | Examples |\n|----------|---------|\n| Lead Generation | Apollo prospecting, company contact finder, signal scanning |\n| Outreach | Cold email, LinkedIn outreach, email drafting |\n| Scraping | Twitter/X, Reddit, LinkedIn, Product Hunt, Hacker News |\n| Research | Competitor intel, ICP identification, meeting briefs |\n| SEO | Content audit, domain analysis, programmatic SEO |\n| Ads | Google/Meta ad scraping, campaign analysis |\n| Enrichment | Contact enrichment, company research, tech stack |\n| Monitoring | Newsletter scanning, review site tracking |\n\n## Ads (`goose-ads`)\n\nAlongside the GTM `gooseworks` skill, the CLI installs a **separate** `goose-ads` entry\nskill for ads — **create** ad creative (remix a static ad template into a branded ad, or\nread a brand for ads) and **analyze** ad performance (Meta/Google campaign diagnostics,\ncreative fatigue, CAC & lead quality, competitor ad intelligence, ad angles & hooks). The\n`gooseworks` parent router also hands ad requests to it. Claude auto-loads whichever skill\nmatches the task; the two are domain-scoped and never merged.\n\n> Renamed from `ads-remix`. Older installs get the stale `ads-remix` skill cleaned up\n> automatically on the next `install`.\n\n```bash\ngooseworks install --claude --mcp\n```\n\nThen in Claude Code: *\"remix template `<id>` for `<your-site>`\"*.\n\n**The GooseWorks MCP server is REQUIRED for ads.** The skill is a thin wrapper over the\nbackend's single ad-generation workflow — the same one the GooseWorks ads app uses — reached\nthrough the `gooseworks` MCP tools (`get_brand_kit`, `submit_remix_batch`, `get_remix_batch`,\n`regenerate_creative`, …). The skill does NOT generate images, drive FAL, or manage renders\nitself; the backend runs the pipeline and stores results. `install` registers the MCP server\nwith `--mcp` (or `--all`) and verifies it's reachable; if it isn't, you'll see a warning — the\nads flow will fail without MCP. Re-run `gooseworks install --claude --mcp` if needed.\n\nGeneration is billed to your GooseWorks credits **server-side**: `submit_remix_batch` reserves\nthe estimated cost up front and bills only the images that complete. There's no separate\nad-credit balance. Use `estimate_remix_batch` (cost preview) and `gooseworks credits` (balance).\n\n### Keeping skills up to date\n\n- **Entry skills** (`gooseworks`, `goose-ads`) are vendored in the CLI. They're (re)installed\n  on `install`/`update`, and **refreshed on `login`** — but only when their content actually\n  changed (a content-hash stamp skips unchanged ones, so re-running is cheap). Bump the CLI\n  (`npx gooseworks@latest …`) to get new entry-skill content.\n- **Recipe skills** (e.g. ad-analytics like `meta-ads-analyzer`) are **fetched live** from\n  goose-skills each time they're used, so they're always current — nothing to update.\n\n## File Layout\n\n### Credentials\n\n```\n~/.gooseworks/\n└── credentials.json      # API key, email, agent_id, api_base\n```\n\n### Skills\n\n```\n~/.agents/skills/\n├── gooseworks/\n│   ├── SKILL.md          # GTM skill — teaches your agent to use 100+ data tools\n│   └── .gooseworks-version  # content-hash stamp (freshness check; skip rewrite if unchanged)\n├── goose-ads/\n│   ├── SKILL.md          # Ads entry skill (create + analyze; creation requires MCP)\n│   └── .gooseworks-version\n└── goose-graphics/\n    └── SKILL.md          # Optional standalone skill installed with --with\n```\n\n### Claude Code Symlinks\n\n```\n~/.claude/skills/\n├── gooseworks → ~/.agents/skills/gooseworks\n├── goose-ads → ~/.agents/skills/goose-ads\n└── goose-graphics → ~/.agents/skills/goose-graphics\n```\n\n### Codex Symlinks\n\n```\n~/.codex/skills/\n├── gooseworks → ~/.agents/skills/gooseworks\n└── goose-graphics → ~/.agents/skills/goose-graphics\n```\n\n## Pricing\n\nNew users get **200 free credits**. Each skill run costs 1-10 credits depending on the data source. Check your balance with `npx gooseworks credits`.\n\nNeed more? Visit [gooseworks.ai/settings](https://app.gooseworks.ai/settings?tab=billing) to add credits.\n\n## Requirements\n\n- Node.js 18+\n- Python 3 (for running skill scripts)\n- Claude Code, Cursor, or Codex\n\n## Links\n\n- [GooseWorks](https://gooseworks.ai)\n- [Skills Catalog](https://skills.gooseworks.ai)\n- [Documentation](https://docs.gooseworks.ai)\n- [Discord](https://discord.gg/gooseworks)\n\n## License\n\nMIT\n",
  "bytes": 13368,
  "sha": "f4273f034bf46f89c6b736b24e1f4ea5bf1f0b4063be4c57166e31f23b5b0fba",
  "repo_slug": "gooseworks-ai/gooseworks",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_gooseworks_ai_gooseworks_gooseworks_51389468/readme"
}