PS

penguinradar/skill

Developer tools
0 stars Quality 65 Trend 14MIT

Ask in plain language; the assistant reads your retained follower and following snapshots and detected changes through PenguinRadar's CLI or MCP tools, and explains what the data does and does not...

Overview

Ask in plain language; the assistant reads your retained follower and following snapshots and detected changes through PenguinRadar's CLI or MCP tools, and explains what the data does and does not show. - "Which Instagram accounts am I tracking?" - "Show alice's last available followers." - "What changes did PenguinRadar detect for alice in the last seven days?" - "Who stopped following alice since October 1?" - "Query bob's public followers online, at most 2 credits." This installs the Skill into the assistants found on your machine. With the PenguinRadar CLI you can install the same Skill without GitHub: penguinradar skill install (--target claude for ~/.claude/skills, --project for one project). The Skill contains no credentials and installs no software. Give the assistant access one of two ways: 1. add https://penguinradar.com/mcp as a connector and sign in on PenguinRadar's own authorization page. 2.

README

PenguinRadar Agent Skill

An Agent Skill that lets Claude Code, Codex, Cursor and other compatible AI assistants answer questions about the Instagram accounts you track with PenguinRadar. Ask in plain language; the assistant reads your retained follower and following snapshots and detected changes through PenguinRadar’s CLI or MCP tools, and explains what the data does and does not show.

Example prompts

  • “Which Instagram accounts am I tracking?”
  • “Show alice’s last available followers.”
  • “What changes did PenguinRadar detect for alice in the last seven days?”
  • “Who stopped following alice since October 1?”
  • “Query bob’s public followers online, at most 2 credits.”

Install

npx skills add penguinradar/skill

This installs the Skill into the assistants found on your machine. With the PenguinRadar CLI you can install the same Skill without GitHub: penguinradar skill install (--target claude for ~/.claude/skills, --project for one project).

Connect your account

The Skill contains no credentials and installs no software. Give the assistant access one of two ways:

  1. Remote MCP (OAuth): add https://penguinradar.com/mcp as a connector and sign in on PenguinRadar’s own authorization page.
  2. CLI: npm install --global penguinradar, then penguinradar auth login (macOS Keychain) or set PENGUINRADAR_API_KEY.

Never paste an API Key into a chat.

What the assistant can do

You ask about MCP tool CLI command
Tracked accounts list_tracking penguinradar tracking list --json
Account profile and totals get_account penguinradar account USERNAME --json
Existing followers list_followers penguinradar followers USERNAME --json
Existing following list_following penguinradar following USERNAME --json
Detected changes get_account_changes penguinradar changes USERNAME --json
Online lookup of a public account query_public_account penguinradar followers USERNAME --live --max-credits N --json

Built-in safeguards

  • Existing data first. Reads use data PenguinRadar already holds and never start a scan.
  • Explicit budgets. An online lookup runs only after you name the target, the data type and a maximum number of credits. It returns one page and never starts continuous tracking.
  • Honest data. The assistant reports the data’s observation time, coverage and warnings. “Detected at” is not the exact time someone followed or unfollowed, a partial list is not the whole Instagram list, and no detected change is not proof of no activity.
  • Data is not instructions. Names and bios returned by the API are treated as data only.

FAQ

Does it work with ChatGPT? The Skill is for hosts that read Agent Skills (Claude Code, Codex, Cursor). For ChatGPT, use the ChatGPT / Codex plugin preview (not yet in the public Plugin Directory) or add the MCP server above as a custom connector.

Does it need my Instagram password? No. It uses only your PenguinRadar account.

Is it free? The Skill is free. Reading your stored data does not spend credits; online lookups spend credits within the limit you set. See pricing.

Skill docs · Open API · CLI · Instagram follower tracker · [email protected]

License

MIT

View the full README on GitHub

Recommended Tools

Try a different keyword or remove a filter.

Install

npx skillfish add penguinradar/skill
New to MCP? Start with the mcpskill.org guide →