# Tokopedia

> Manage Tokopedia shop products, orders, and inventory via the Seller API.

- Skill: `qhkm/tokopedia` (Agent Skill)
- Install (CLI): `npx skillmds@latest add qhkm/tokopedia`
- Raw SKILL.md: https://api.skillmd.com/api/skills/qhkm/tokopedia/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT
- Author: qhkm (https://skillmd.com/u/qhkm)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/qhkm/tokopedia

---


# Tokopedia Skill

Manage products, orders, and shop info on Tokopedia — Indonesia's largest marketplace.

## Setup

1. Register at [developer.tokopedia.com](https://developer.tokopedia.com)
2. Create an app and get OAuth2 credentials
3. Get access token:

```bash
export TOKOPEDIA_CLIENT_ID="your_client_id"
export TOKOPEDIA_CLIENT_SECRET="your_client_secret"
export TOKOPEDIA_SHOP_ID="your_shop_id"
```

## Get Access Token

```bash
export TOKOPEDIA_ACCESS_TOKEN=$(curl -s -X POST "https://accounts.tokopedia.com/token" \
  -u "$TOKOPEDIA_CLIENT_ID:$TOKOPEDIA_CLIENT_SECRET" \
  -d "grant_type=client_credentials" \
  | jq -r '.access_token')
```

## List Products

```bash
curl -s "https://fs.tokopedia.net/inventory/v1/fs/$TOKOPEDIA_CLIENT_ID/product/info?shop_id=$TOKOPEDIA_SHOP_ID&page=1&per_page=20" \
  -H "Authorization: Bearer $TOKOPEDIA_ACCESS_TOKEN" \
  | jq '.data[] | {id: .basic.productID, name: .basic.name, price: .price.value, stock: .stock.value}'
```

## List Orders

```bash
curl -s "https://fs.tokopedia.net/v2/order/list?shop_id=$TOKOPEDIA_SHOP_ID&page=1&per_page=20&fs_id=$TOKOPEDIA_CLIENT_ID" \
  -H "Authorization: Bearer $TOKOPEDIA_ACCESS_TOKEN" \
  | jq '.data[] | {order_id, status, buyer: .buyer_info.name, total: .amt.total_amount}'
```

## Accept an Order

```bash
ORDER_ID="order-id"
curl -s -X POST "https://fs.tokopedia.net/v1/order/$ORDER_ID/fs/$TOKOPEDIA_CLIENT_ID/ack" \
  -H "Authorization: Bearer $TOKOPEDIA_ACCESS_TOKEN" \
  | jq '.header.process_time'
```

## Get Shop Info

```bash
curl -s "https://fs.tokopedia.net/v1/shop/fs/$TOKOPEDIA_CLIENT_ID/shop-info?shop_id=$TOKOPEDIA_SHOP_ID" \
  -H "Authorization: Bearer $TOKOPEDIA_ACCESS_TOKEN" \
  | jq '.data[] | {id: .shop_id, name: .shop_name, domain, reputation}'
```

## Tips

- OAuth2 token expires in ~1 hour — implement refresh
- Base URL: `fs.tokopedia.net` (fulfillment service)
- Shop ID is numeric — find it in your seller dashboard URL
- Rate limit varies by endpoint (~50 req/min typical)
- Order statuses: 0 (seller), 100 (payment verified), 220 (shipped), 400 (delivered), 700 (completed)
- Custom MCP server planned for `qhkm/zeptoclaw-sea` repo