pp-tiktok-shop

TikTok Shop - Printing Press Safe v1

前提条件：CLI をインストールする

このスキルは tiktok-shop-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**インストールされていない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。バイナリの既定のインストール先は、macOS/Linux では $HOME/.local/bin、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin です。

   npx -y @mvanhorn/printing-press-library install tiktok-shop --cli-only
   

2. 確認します：tiktok-shop-pp-cli --version
3. スキルを実行するエージェント／ランタイムの $PATH に、報告されたインストールディレクトリが含まれていることを確認します。

npx によるインストールが失敗した場合（Node がない、オフラインなど）は、Go から直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/commerce/tiktok-shop/cmd/tiktok-shop-pp-cli@latest

インストール後に --version が「command not found」と報告する場合、ランタイムからバイナリのディレクトリを $PATH 経由で参照できていません。確認が成功するまで、スキルのコマンドを実行しないでください。

公式情報源の範囲

API、認証、署名、スコープ、エンドポイント、レート制限に関する記述には、TikTok Shop Partner Center の公式ドキュメントのみを使用してください。

• Seller API の概要：https://partner.tiktokshop.com/docv2/page/650b1f2ff1fd3102b93c6d3d
• 認証の概要：https://partner.tiktokshop.com/docv2/page/678e3a3292b0f40314a92d75
• 認証ガイド：https://partner.tiktokshop.com/docv2/page/678e3a2dbd083702fd17455c
• 署名アルゴリズム：https://partner.tiktokshop.com/docv2/page/678e3a3d4ddec3030b238faf
• 認証済みショップの取得：https://partner.tiktokshop.com/docv2/page/6507ead7b99d5302be949ba9
• アクティブなショップの取得：https://partner.tiktokshop.com/docv2/page/650a69e24a0bb702c067291c
• 注文リストの取得：https://partner.tiktokshop.com/docv2/page/650aa8094a0bb702c06df242
• 注文詳細の取得：https://partner.tiktokshop.com/docv2/page/650aa8ccc16ffe02b8f167a0
• 商品の検索：https://partner.tiktokshop.com/docv2/page/6503081a56e2bb0289dd6d7d
• 商品の取得：https://partner.tiktokshop.com/docv2/page/6509d85b4a0bb702c057fdda
• 在庫の検索：https://partner.tiktokshop.com/docv2/page/650a9191c16ffe02b8eec161
• 在庫の更新、保留中：https://partner.tiktokshop.com/docv2/page/6503068fc20ad60284b38858
• 倉庫リストの取得：https://partner.tiktokshop.com/docv2/page/650aa418defece02be6e66b6
• 荷物の検索：https://partner.tiktokshop.com/docv2/page/650aa592bace3e02b75db748
• 荷物の詳細の取得：https://partner.tiktokshop.com/docv2/page/650aa39fbace3e02b75d8617

参照可能な公式ドキュメントではレート制限が明確になっていないため、数値による記述は含めていません。

コマンドリファレンス

実装済み：

• tiktok-shop-pp-cli doctor - 設定、環境変数、認証の準備状況、公式ドキュメントに基づく情報を確認します。実際のプローブは送信しません。
• tiktok-shop-pp-cli auth status - 秘密情報を表示せずに、アプリの認証情報、トークン、ショップセレクターが設定されているかを表示します。
• tiktok-shop-pp-cli auth exchange --auth-code <code> - Partner Center の認証コードをトークンと交換します。出力ではトークンが伏せられます。
• tiktok-shop-pp-cli auth refresh - アクセストークンを更新します。出力ではトークンが伏せられます。
• tiktok-shop-pp-cli shops info - このアプリ／トークンで認可されたショップを一覧表示し、ショップの cipher を取得します。
• tiktok-shop-pp-cli orders list - 注文を検索します。レスポンスには購入者／注文の個人識別情報（PII）が含まれます。
• tiktok-shop-pp-cli orders get <order-id> - 注文の詳細を取得します。レスポンスには購入者／注文の個人識別情報（PII）が含まれます。
• tiktok-shop-pp-cli products list - 商品／出品を検索します。
• tiktok-shop-pp-cli products get <product-id> - 商品の詳細を取得します。
• tiktok-shop-pp-cli inventory list --product-id <id> または --sku-id <id> - 在庫を検索します。
• tiktok-shop-pp-cli inventory get <sku-id> - 1 つの SKU の在庫を取得します。
• tiktok-shop-pp-cli fulfillment list - フルフィルメントパッケージを検索します。レスポンスにはフルフィルメントに関する個人識別情報（PII）が含まれる場合があります。
• tiktok-shop-pp-cli fulfillment get <package-id> - パッケージの詳細を取得します。
• tiktok-shop-pp-cli fulfillment warehouses - 販売者の倉庫を一覧表示します。
• tiktok-shop-pp-cli which [query] - 機能を対応するコマンドに解決します。
• tiktok-shop-pp-cli agent-context - エージェント向けの JSON コンテキストを出力します。

保留中：

• tiktok-shop-pp-cli inventory update - 公式エンドポイントは確認済みですが、冪等性と再試行を行わない変更処理の設計が完了するまで、安全性を考慮して v1 では実行を保留しています。

認証の設定

公式の TikTok Shop Partner Center のフローで取得した値を設定してください。秘密情報をハードコードしないでください。

export TIKTOK_SHOP_APP_KEY="<from Partner Center>"
export TIKTOK_SHOP_APP_SECRET="<from Partner Center>"
export TIKTOK_SHOP_ACCESS_TOKEN="<from official token exchange>"
export TIKTOK_SHOP_REFRESH_TOKEN="<from official token exchange>"
export TIKTOK_SHOP_SHOP_CIPHER="<from shops info>"

オプションのオーバーライド：

export TIKTOK_SHOP_CONFIG="$HOME/.config/tiktok-shop-pp-cli/config.toml"
export TIKTOK_SHOP_BASE_URL="https://open-api.tiktokglobalshop.com"
export TIKTOK_SHOP_AUTH_BASE_URL="https://auth.tiktok-shops.com"

実行：

tiktok-shop-pp-cli doctor --json

トークンの交換／更新では、トークン値は出力されません。返されたトークンバンドルを ~/.config/tiktok-shop-pp-cli/config.toml に 0600 の権限で永続化する場合に限り、意図的に --save を追加してください。

エージェントモード

任意のコマンドに --agent を追加できます。これは --json --compact --no-input --no-color --yes に展開されます。

エージェントに安全な使用例：

tiktok-shop-pp-cli doctor --agent
tiktok-shop-pp-cli shops info --agent --dry-run
tiktok-shop-pp-cli which --agent
tiktok-shop-pp-cli inventory update --agent

安全ルール

• 注文、フルフィルメント、返品、購入者識別子は個人識別情報（PII）として扱ってください。
• shops info を使用して shop_cipher を取得してください。ショップの cipher を推測したり、復号したりしないでください。
• 実際に呼び出す前に --dry-run を使用し、送信せずに署名付きリクエストの形式を確認してください。
• 変更処理を再試行しないでください。安全な v1 で実行するのは、読み取りコマンドと認証トークンの呼び出しのみです。
• API の動作が不明な場合、非公式エンドポイント、SDK の推測、ブログ記事、コピーされた Postman コレクションを使用しないでください。

終了コード

コード	意味
0	成功。意図的な保留中のプレースホルダー出力を含む
1	未分類のエラー
2	使用方法のエラー
4	認証／設定情報が不足しています
5	上流 API エラー
7	レート制限中
10	設定エラー

引数の解析

$ARGUMENTS を解析します：

1. 空、help、または --help の場合は、tiktok-shop-pp-cli --help を表示します。
2. install で始まり mcp で終わる場合は MCP のインストール、それ以外の場合は CLI のインストールです。
3. それ以外は --agent を付けた直接使用です。

MCP サーバーのインストール

go install github.com/mvanhorn/printing-press-library/library/commerce/tiktok-shop/cmd/tiktok-shop-pp-mcp@latest
claude mcp add tiktok-shop-pp-mcp -- tiktok-shop-pp-mcp

MCP サーバーは、安全な v1 の読み取り機能と、在庫変更ツールの代わりに説明用の inventory_update_status を公開します。