Authenticate the skill, link Instagram, and inspect the hosted API from one CLI.

The supported workflow is now one installable skill with a bundled CLI. The browser still completes Google sign-in and the Instagram linking handoff, but data access runs through the hosted REST API instead of MCP.

Link Instagram

Readiness

Google session

Not signed in yet

Instagram link

Not linked yet

Latest sync

No sync run recorded yet

Claude Marketplace

Add the GitHub repo as a Claude marketplace.

/plugin marketplace add https://github.com/kingscrosslabs/marketplace.git

Skill Install

Install the Instasights skill package from the marketplace.

/plugin install instagram@kingscrosslabs-marketplace

CLI Auth Login

Start the hosted OAuth flow and finish Google sign-in in the browser.

./skills/instasights/instasights auth login

Setup Status

Check whether auth, Instagram linking, and sync freshness are ready.

./skills/instasights/instasights setup status

Sync And Wait

Queue a sync if needed and poll until it reaches a terminal state.

./skills/instasights/instasights sync run --wait

Link Instagram

Open the hosted Instagram OAuth handoff from the CLI.

./skills/instasights/instasights instagram link --open

Bundled CLI

The supported interface is now the skill-local macOS `instagram` CLI bundled with the installable skill.

Browser handoffs

Google sign-in and Instagram linking still happen here in the browser, then the CLI resumes locally with stored tokens.

Legacy API keys

Personal API keys remain available for compatibility scripts, but they are no longer the primary product path.

Recommended Flow

The skill should drive the CLI in this order.

1. Install the Instasights skill from the marketplace.

2. Run `auth login` and finish Google sign-in in the browser.

3. Run `setup status` to inspect readiness.

4. If needed, run `instagram link --open` and finish the Meta handoff.

5. Run `sync run --wait` when the account is not synced or stale.

6. Use `account overview`, `snapshot latest`, and `media` commands for analysis.

Legacy API Key Smoke Test

Direct REST validation for the compatibility API-key path.

curl -H "Authorization: Bearer $INSTASIGHTS_API_KEY" \
  https://instasights.kingscrosslabs.com/api/v1/account