[Integrations](https://spiral.ai/integrations) › [opencode](https://spiral.ai/integrations/opencode) › [TikTok Shop Shop Search](https://spiral.ai/integrations/opencode/tiktok-shop-shop-search)

# How to Use TikTok Shop Shop Search in opencode

TikTok Shop product search returns matching listings with titles, product links, seller information, sold counts, ratings, and review counts. Use it to find products across shops and compare the returned listings for a category or brand.

|  |  |
| --- | --- |
| Model | TikTok Shop Shop Search |
| Available through | ScrapeCreators |
| Category | E-commerce |
| Price | Up to $0.0013 per run. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with TikTok Shop Shop Search in opencode

- Use TikTok Shop product search for 'Crocs Classic Clogs' in the US and add a comparison table to this project with product titles, sellers, sold counts, ratings, review counts, and product links.
- Use TikTok Shop product search for 'makeup brush' in the US and create a CSV in this repository containing the returned product IDs, titles, sellers, ratings, and review counts.
- Use TikTok Shop product search for 'insulated tumbler' in the US and compare the returned product IDs and sold counts with our project's previous saved results.
- Use TikTok Shop product search for 'running shoes' and 'walking shoes' in the US, then add a report to this project showing shared product IDs and titles unique to each search.
- Use TikTok Shop product search for 'resistance bands' in the US and populate this project's seller comparison view with the returned titles, ratings, review counts, and product links.

## How to set up TikTok Shop Shop Search in opencode

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Leave out `--global` to add Spiral to the current project only. No header and no client ID or secret: opencode registers itself with Spiral.

```bash
opencode mcp add spiral --global --url https://api.spiral.ai/mcp
```

2. **Sign in**: Your browser opens. Sign in to Spiral, pick the organization and click Authorize, then return to the terminal. No API key. Inside opencode, `/mcps` starts the same sign-in.

```bash
opencode mcp auth spiral
```

3. **Check it**: Spiral shows as connected.

```bash
opencode mcp list
```

### Use the Spiral skill

1. **Send opencode this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run TikTok Shop Shop Search**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "scrapecreators",
    "model": "scrapecreators/tiktok-shop-search",
    "input": {
      "query": "shoes"
    }
  }'
```

Then paste one of the prompts above: opencode finds TikTok Shop Shop Search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/opencode

## TikTok Shop Shop Search tools and prices

- [TikTok Shop · Shop Search](https://spiral.ai/tools/scrapecreators/scrapecreators/tiktok-shop-search) (ScrapeCreators): Up to $0.0013 per run.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| page |  | — | Page number to retrieve |
| region | US, GB, DE, FR, IT, ID, MY, MX, PH, SG, ES, TH, VN, BR, JP, IE | — | Region to search shop products in. Non-US TikTok Shop regions are not reliable right now and may return limited or inconsistent results. Sorry for the inconvenience. |

## What can you do with TikTok Shop Shop Search in opencode?

Build a category comparison table in your project from TikTok Shop product titles, sellers, ratings, and sold counts. Use product IDs to match listings across searches and link each row to its product page.

### Compare products within a category

Search for makeup brushes and compare the returned listings by seller, sold count, rating, and review count. Include product links so a merchandiser can inspect the shortlist.

### Review listings mentioning a brand

Search for Crocs Classic Clogs and group matching product titles by seller. Give a brand team a linked list of listings to review without assuming that a brand mention proves seller authorization.

### Prepare an affiliate research shortlist

Find products matching a creator's public content niche, such as kitchen storage. Compare sold counts and review counts to select listings for further editorial review.

### Monitor changes in returned listings

Repeat searches for insulated tumblers and compare matching product IDs across saved runs. Report newly observed listings and changes in reported sold counts or review counts.

### Compare product wording

Search separately for running shoes, walking shoes, and gym shoes. Compare returned titles and overlapping product IDs to choose more precise terms for subsequent research.

### Build a seller comparison brief

Search for resistance bands and group the returned products by seller. Summarize each seller's matching listings, ratings, review counts, and product links within the retrieved results.

## Overview

- [ScrapeCreators](https://spiral.ai/providers/scrapecreators)
- [All opencode guides](https://spiral.ai/integrations/opencode)

## TikTok Shop Shop Search in other agents

- [Amp](https://spiral.ai/integrations/amp/tiktok-shop-shop-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/tiktok-shop-shop-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/tiktok-shop-shop-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/tiktok-shop-shop-search)
- [Cline](https://spiral.ai/integrations/cline/tiktok-shop-shop-search)
- [Codex](https://spiral.ai/integrations/codex/tiktok-shop-shop-search)
- [Cursor](https://spiral.ai/integrations/cursor/tiktok-shop-shop-search)
- [Devin](https://spiral.ai/integrations/devin/tiktok-shop-shop-search)
- [dots](https://spiral.ai/integrations/dots/tiktok-shop-shop-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/tiktok-shop-shop-search)
- [Gemini](https://spiral.ai/integrations/gemini/tiktok-shop-shop-search)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/tiktok-shop-shop-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/tiktok-shop-shop-search)
- [goose](https://spiral.ai/integrations/goose/tiktok-shop-shop-search)
- [Grok](https://spiral.ai/integrations/grok/tiktok-shop-shop-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/tiktok-shop-shop-search)
- [Hermes](https://spiral.ai/integrations/hermes/tiktok-shop-shop-search)
- [Instinct](https://spiral.ai/integrations/instinct/tiktok-shop-shop-search)
- [Manus](https://spiral.ai/integrations/manus/tiktok-shop-shop-search)
- [Muse](https://spiral.ai/integrations/muse/tiktok-shop-shop-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/tiktok-shop-shop-search)
- [n8n](https://spiral.ai/integrations/n8n/tiktok-shop-shop-search)
- [Notion](https://spiral.ai/integrations/notion/tiktok-shop-shop-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/tiktok-shop-shop-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/tiktok-shop-shop-search)
- [Raycast](https://spiral.ai/integrations/raycast/tiktok-shop-shop-search)
- [VS Code](https://spiral.ai/integrations/vscode/tiktok-shop-shop-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/tiktok-shop-shop-search)
- [Zapier](https://spiral.ai/integrations/zapier/tiktok-shop-shop-search)

## More opencode guides

- [TikTok Shop Product Reviews ScrapeCreators](https://spiral.ai/integrations/opencode/tiktok-shop-product-reviews-scrapecreators)
- [TikTok Shop US mobile product search](https://spiral.ai/integrations/opencode/tiktok-shop-us-mobile-product-search)
- [TikTok Shop Product Details ScrapeCreators](https://spiral.ai/integrations/opencode/tiktok-shop-product-details-scrapecreators)
- [TikTok Shop US mobile seller products](https://spiral.ai/integrations/opencode/tiktok-shop-us-mobile-seller-products)
- [TikTok Shop ID from share link](https://spiral.ai/integrations/opencode/tiktok-shop-id-from-share-link)
- [TikTok Shop category tree](https://spiral.ai/integrations/opencode/tiktok-shop-category-tree)

## Questions about TikTok Shop Shop Search in opencode

**Can opencode use TikTok Shop Shop Search?**

Yes. Add Spiral to opencode as an MCP server, and opencode can find and run TikTok Shop Shop Search like any built-in tool.

**How much does TikTok Shop Shop Search cost in opencode?**

Up to $0.0013 per run. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your opencode plan is separate.

**Do I need a ScrapeCreators account to use TikTok Shop Shop Search in opencode?**

No. Spiral runs TikTok Shop Shop Search on its own ScrapeCreators account. You sign in to Spiral once and never paste a key.

**How long does it take to set up TikTok Shop Shop Search in opencode?**

About two minutes: add the server, then sign in, then check it.

**Does opencode wait while TikTok Shop Shop Search runs?**

TikTok Shop Shop Search runs in the background. opencode starts the run, checks on it and gives you the json when it's ready.

**What information comes back for a TikTok Shop product?**

Search results include product titles, IDs, links, sold counts, and seller information. The documented response also includes product rating scores and review counts.

**How reliable is coverage outside the US?**

ScrapeCreators explicitly warns that non-US TikTok Shop searches are unreliable and may return limited or inconsistent results. A sparse result set outside the US should not be presented as a complete category inventory.

**How fresh is the data?**

ScrapeCreators describes its extraction as real-time access to the latest public platform data. That describes retrieval freshness; it does not establish how frequently TikTok updates a product's sold count or rating.

**Does this provide private TikTok Shop data?**

ScrapeCreators describes its extraction as public data only. Use this search for public product listings and seller information.

**Can I retrieve additional search results?**

Yes. TikTok Shop search supports numbered result pages, so an agent can request subsequent pages for the same search.

