manychat-cli

# ManyChat CLI Skill

Use this skill when you need to automate ManyChat operations from OpenClaw or other AI agents.

## What this skill provides
- A local CLI wrapper at `/Users/danielfoch/manychat-cli/manychat_cli.py`
- Stable JSON output and exit codes for automation orchestration
- High-value ManyChat commands:
  - subscriber lookup and profile reads
  - tag add/remove
  - custom field updates
  - flow/content sends
  - create/update subscriber
  - raw endpoint passthrough
  - JSON playbook execution for sequential automation steps

## Requirements
- `MANYCHAT_API_KEY` environment variable must be set.
- Optional: `MANYCHAT_BASE_URL` to override API host.

## Usage

Validate token:
```bash
cd /Users/danielfoch/manychat-cli
./manychat_cli.py ping --pretty
```

Find by email:
```bash
./manychat_cli.py find-system --field-name email --field-value 'lead@example.com' --pretty
```

Run a multi-step playbook:
```bash
./manychat_cli.py playbook-run \
  --file /Users/danielfoch/manychat-cli/sample_playbook.json \
  --vars-json '{"email":"lead@example.com"}' \
  --pretty
```

## File references
- CLI: `/Users/danielfoch/manychat-cli/manychat_cli.py`
- Playbook example: `/Users/danielfoch/manychat-cli/sample_playbook.json`
- Shell example: `/Users/danielfoch/manychat-cli/example_automation.sh`
- Extended docs: `/Users/danielfoch/manychat-cli/README.md`

# ManyChat CLI (Agent-Friendly)

A lightweight CLI wrapper around the ManyChat API for OpenClaw and other AI agents.

## Why this exists
- Consistent JSON output (`{"ok": true|false, ...}`)
- Explicit, automation-safe exit codes
- Prebuilt commands for common automation actions
- `raw` passthrough for any endpoint not yet wrapped
- `playbook-run` for multi-step automations in JSON

## File
- `/Users/danielfoch/manychat-cli/manychat_cli.py`

## Requirements
- Python 3.9+
- A ManyChat API key

## Setup
```bash
cd /Users/danielfoch/manychat-cli
export MANYCHAT_API_KEY='your-manychat-api-key'
./manychat_cli.py ping --pretty
```

Optional:
```bash
export MANYCHAT_BASE_URL='https://api.manychat.com'
```

## Commands
```bash
./manychat_cli.py --help
```

Core commands:
- `ping` -> `/fb/page/getInfo`
- `page-tags` -> `/fb/page/getTags`
- `page-fields` -> `/fb/page/getCustomFields`
- `page-flows` -> `/fb/page/getFlows`
- `sub-info` -> `/fb/subscriber/getInfo`
- `find-system` -> `/fb/subscriber/findBySystemField`
- `find-custom` -> `/fb/subscriber/findByCustomField`
- `tag-add` / `tag-remove`
- `field-set` / `fields-set`
- `flow-send` -> `/fb/sending/sendFlow`
- `content-send` -> `/fb/sending/sendContent`
- `sub-create` / `sub-update`
- `playbook-run` (multi-step automation runner)
- `raw` (generic endpoint caller)

## Examples
Find subscriber by email:
```bash
./manychat_cli.py find-system --field-name email --field-value 'lead@example.com' --pretty
```

Add tag by name:
```bash
./manychat_cli.py tag-add --subscriber-id 123456 --tag-name 'Hot Lead' --pretty
```

Set custom field by id:
```bash
./manychat_cli.py field-set --subscriber-id 123456 --field-id 789 --value 'Toronto' --pretty
```

Send flow:
```bash
./manychat_cli.py flow-send --subscriber-id 123456 --flow-ns 'main_onboarding' --pretty
```

Call any endpoint directly:
```bash
./manychat_cli.py raw /fb/page/getTags --data '{}' --pretty
```

Run playbook:
```bash
./manychat_cli.py playbook-run \
  --file /Users/daniel...