How do I install the Tokopedia skill?

Run npx skillmds@latest add qhkm/tokopedia in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Tokopedia skill do?

Manage Tokopedia shop products, orders, and inventory via the Seller API. It is listed under Integrations & APIs on SkillMD.

Is Tokopedia safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Tokopedia?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Tokopedia free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under MIT.

Who published Tokopedia?

qhkm (@qhkm) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Tokopedia by qhkm — Agent Skill

Name: Tokopedia
Author: qhkm

File contents

Tokopedia Skill

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

Setup

Register at developer.tokopedia.com
Create an app and get OAuth2 credentials
Get access token:

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

Get Access Token

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

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

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

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

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

---name: tokopediadescription: Manage Tokopedia shop products, orders, and inventory via the Seller API.license: MIT---# Tokopedia SkillManage products, orders, and shop info on Tokopedia — Indonesia's largest marketplace.## Setup1. Register at [developer.tokopedia.com](https://developer.tokopedia.com)2. Create an app and get OAuth2 credentials3. Get access token:```bashexport TOKOPEDIA_CLIENT_ID="your_client_id"export TOKOPEDIA_CLIENT_SECRET="your_client_secret"export TOKOPEDIA_SHOP_ID="your_shop_id"```## Get Access Token```bashexport 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```bashcurl -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```bashcurl -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```bashORDER_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```bashcurl -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

Frequently asked questions

Tokopedia