# PipiSpy through toolfare

> TikTok ad-spy data from PiPiADS — which ads are running, for which advertisers and for how long, and a single advertiser’s detail — answered inside ChatGPT, Claude, Codex or Cursor. No PiPiADS plan or key of your own: toolfare buys each call, quotes it first, and charges what the gateway reports the call cost.

Page: https://toolfare.ai/pipispy

## Use it from your agent

Paste this into Claude Code, Codex, Cursor or any agent with a shell:

> Set up https://toolfare.ai/skill.md, then use toolfare to answer: What TikTok ads are running in the skincare niche?

Apps without a terminal connect toolfare as an MCP server: https://toolfare.ai/docs#connect

## Use it from a script

```sh
mkdir -p ~/.local/bin
curl -fsSL 'https://toolfare.ai/toolfare/toolfare.mjs' -o ~/.local/bin/toolfare
chmod +x ~/.local/bin/toolfare
export PATH="$HOME/.local/bin:$PATH"
export TOOLFARE_MCP_URL='https://api.toolfare.ai/mcp'
toolfare login
```

Sign in once per machine; the CLI renews the sign-in itself. On a CI runner or another server, create an API key in the toolfare console and set it as `TOOLFARE_API_KEY` instead of signing in. Paid calls on one sign-in or key run one at a time. `--max-cost` refuses a call quoted above that many credits (1,000 credits = $3).

## Tools

### Running TikTok ads and the advertisers behind them

Tool: `pipispy_query`

Lists running TikTok ads that match your filters, or reads one advertiser’s detail — the ads, the advertisers and how long they have run.

Ask:
- What TikTok ads are running in the skincare niche?
- Find the top advertisers for this product category.
- How long has this advertiser been running its current creatives?

### Also available

- `pipispy_advertiser_detail`: Read an advertiser profile
- `pipispy_advertisers`: Search the advertiser leaderboard

## Price

Quoted to your AI before the call runs, then charged on the credits PiPiADS reports for that exact call. Metered from the `consumed_credits` the gateway returns in its own response — a filtered list consumes fewer credits than a broad one. No fixed price table, on purpose: the credit cost comes back with the data. A call that fails is never charged.

Balances and top-ups are in US dollars. Quotes and `--max-cost` count credits: 1,000 credits = $3 ($0.003 each).

## Use it when

- You want TikTok ad-spy data: which ads are running, for whom, and how long.
- You are researching advertisers and creatives in a niche before launching into it.

## Look elsewhere when

- You want Meta or multi-network creatives. Another ad library covers those and filters more easily.
- You want your own TikTok ad performance. That is your ad account, free, with real spend.

## Limits

- TikTok ads only.
- Ad-spy data shows what ran and for how long, not what it spent or converted.
- Pay as you go from your toolfare balance, in US dollars; there is no subscription. A call runs when your balance covers its quote.