ULTRA SOCIAL ツールカタログ

⚡

FastMoss 市場データAPI

API手順書 (.md)

FastMossのAPIを叩いて、TikTok Shop全体 & カテゴリ別の月次GMVを取得する。スライド作成やトレンド分析の元データ。

横展開OK

横展開するには？

カテゴリID（pcid）を変えるだけ。例: 美容=14, 食品=別ID。region=JPは共通。

~/.claude/.../memory/reference_fastmoss_market_api.md

クリックして詳細を見る

💬 こう指示すればOK

「FastMossで3月の市場データ取って」

「美容カテゴリの月次GMV、7月から全部出して」

「食品カテゴリの市場規模も同じ方法で取れる？」

📤 こう返ってくる

月別のGMV一覧（億円単位）
例: 2025-07: 4.08億 / 2025-08: 12.31億...
JSON保存 → そのままチャート・PPTX化可能

⚠️ 前提条件

FastMossにログイン済みであること
Playwrightのfastmoss_profileが有効
ログイン切れの場合は「ログインして」と言われる

📅 使用実績

2026-03-19 ReFa 8ヶ月分市場データ収集
2026-04-02 ReFa 9ヶ月分（+3月）市場データ更新

PY

fastmoss_collect.py

スクリプト (.py)

FastMossから商品ランキング・競合データ・スクリーンショットを対話メニューで収集する。手動実行向け。

横展開OK

横展開するには？

CATEGORY_ID（14→別カテゴリ）と出力フォルダパスを変更。

~/Desktop/ReFa/tools/fastmoss_collect.py

クリックして詳細を見る

💬 こう指示すればOK

「FastMossでReFaの競合ランキング取って」

「Wavytalk JPのFastMossデータ収集して」

📤 こう返ってくる

Excel (.xlsx) ファイル
・セラーランキング
・競合セラーの3ファイル（Creators/LIVE/Product）
・市場スクリーンショット (.png)

⚠️ 前提条件

fastmoss_setup.py でセッション保存済み
Playwrightがインストール済み

📅 使用実績

2026-03-13 ReFa競合10社のデータ収集

PY

fastmoss_bulk_collect.py

スクリプト (.py)

FastMossのランキングExcelに載っている複数セラーのデータを一括自動収集。大量のセラーを一度に処理。

自動実行横展開OK

横展開するには？

ランキングExcelのパスと出力フォルダを差し替え。

~/Desktop/ReFa/tools/fastmoss_bulk_collect.py

クリックして詳細を見る

💬 こう指示すればOK

「ランキング上位20社のFastMossデータ全部取って」

「美容カテゴリTop10のセラーデータ一括収集」

📤 こう返ってくる

セラーごとに3ファイル×N社分のExcel
external/competitor/seller/{名前}/ に自動保存

PY

collect_categories.py

スクリプト (.py)

FastMossから指定カテゴリの商品ランキングExcelを一括ダウンロード。市場規模の算出に使う。

横展開OK

横展開するには？

カテゴリIDリストと出力フォルダを変更。

~/Desktop/fastmoss_dashboard/collect_categories.py

クリックして詳細を見る

💬 こう指示すればOK

「ドライヤー・アイロン・シャンプーの商品ランキング取って」

📤 こう返ってくる

カテゴリ別の商品ランキングExcel
商品名・価格・販売数・GMV等

PY

collect_l2.py

スクリプト (.py)

FastMossのL2（サブカテゴリ）別データを月ごとに一括ダウンロード。L3の推定に使う。

横展開OK

横展開するには？

L2カテゴリ指定と出力フォルダを変更。

~/Desktop/fastmoss_categories/collect_l2.py

クリックして詳細を見る

💬 こう指示すればOK

「ヘアケア・美容家電・バスボディの月別L2データ取って」

📤 こう返ってくる

L2カテゴリ×月別のExcelファイル群
~/Desktop/fastmoss_categories/L2_raw/ に保存

PY

fastmoss_setup.py

セットアップ (.py)

FastMossにログインしてセッション情報を保存。他のFastMossスクリプトを動かす前に1回実行が必要。

横展開するには？

共通。1回ログインすれば全スクリプトで使える。

~/Desktop/ReFa/tools/fastmoss_setup.py

クリックして詳細を見る

💬 こう指示すればOK

「FastMossにログインしたい」

（セッション切れ時）「FastMossログインし直して」

📤 こう返ってくる

Chromiumブラウザが開く → 手動でログイン → セッション保存完了
保存先: ~/.magi/fastmoss_profile/

PY

update.py (競合ダッシュボード)

スクリプト (.py)

FastMossからTop10セラー+自社データを収集し、競合比較ダッシュボードを自動更新。Netlifyにデプロイ可能。

自動実行横展開OK

横展開するには？

ランキングExcelとデータ出力先を差し替え。Netlify Site IDも新規作成。

~/Desktop/fastmoss_dashboard/update.py

クリックして詳細を見る

💬 こう指示すればOK

「競合ダッシュボード更新して」

「ReFaの競合Top10のダッシュボードをNetlifyにデプロイ」

📤 こう返ってくる

Chart.js付きHTMLダッシュボード
URL: refa-competitor-dashboard.netlify.app
GMV比較・クリエイター数・LIVE回数等のグラフ

PY

generate.py (HTML生成)

スクリプト (.py)

FastMoss競合データ（7日/28日/90日）をChart.js付きHTMLダッシュボードに変換。ブラウザで見れるレポート。

自動実行横展開OK

横展開するには？

データフォルダパスとHTML出力パスを変更。

~/Desktop/fastmoss_dashboard/generate.py

クリックして詳細を見る

💬 こう指示すればOK

「最新データでダッシュボードHTML再生成して」

📤 こう返ってくる

index.html（Chart.js埋め込み）
期間切り替え（7d/28d/90d）対応のインタラクティブグラフ

MD

競合セラーデータ定義

スキーマ (.md)

FastMossからエクスポートした競合セラーデータ（クリエイター/LIVE/商品）の3ファイル構成とカラム定義。

横展開OK

~/Desktop/ReFa/external/competitor/seller/schema.md

クリックして詳細を見る

💬 こう指示すればOK

「この競合データのカラム定義教えて」

「Wavytalkの商品データからGMV上位5つ出して」

📤 こう返ってくる

3ファイルの構造説明:
*_Creators_*.xlsx（1行=1クリエイター）
*_shop LIVE_*.xlsx（1行=1配信）
*_product+data_*.xlsx（1行=1商品）

MD

市場ランキング定義

スキーマ (.md)

FastMossカテゴリ別セラー売上ランキングExcelのカラム定義。Revenue列の「円861.7万」パース方法も記載。

横展開OK

~/Desktop/ReFa/external/market/ranking/schema.md

クリックして詳細を見る

💬 こう指示すればOK

「ランキングExcelの構造教えて」

📤 こう返ってくる

13カラム定義: Shop Name, Revenue(「円861.7万」形式), Sales MoM, Active Products数等

MD

FastMossデータ検証ルール

判断ルール (.md)

FastMossのデータは推計値。精密に見せない・カテゴリマッピング確認・スクショ保存・スポットチェック必須。

Claude判断用

~/.claude/.../memory/feedback_fastmoss_data_verification.md

クリックして詳細を見る

🧠 Claudeはこう動く

・FastMossデータは「推計」と必ず明記
・カテゴリマッピングを確認（L2/L3のズレ注意）
・UI表示のスクショを保存して証跡を残す
・API値とUI値のスポットチェックを行う
・セラセン実数がある場合はそちらを優先

PY

tts_api_client.py

スクリプト (.py)

TikTok Seller Centerの内部APIを叩いて、動画分析・トラフィックソース・クリエイター別データをCSVに変換。公式データ。

横展開OK

横展開するには？

SELLER_IDとブラウザプロファイルを差し替え。APIエンドポイントは共通。

~/Desktop/MAGI システム/_test_auto_dl/tts_api_client.py

クリックして詳細を見る

💬 こう指示すればOK

「セラセンから動画分析データ取って」

「ReFaのトラフィックソース別データをCSVで出して」

「クリエイター別パフォーマンスデータ取得して」

📤 こう返ってくる

CSVファイル（日別）:
・動画GMV、クリック数、CTR、注文数
・トラフィックソース別（For You/検索/プロフィール）
・クリエイター別売上

⚠️ 前提条件

TSP経由でセラーセンターにログイン済み
Chromeでも同じセラセンにログイン状態を維持
読み取り専用（PUT/DELETE等は安全フィルタでブロック）

📅 使用実績

2026-03-31 ReFa 本番データ取得成功（7API確認済み）

PY

tts_api_sniffer.py

スクリプト (.py)

Seller Centerの内部API通信をキャプチャして一覧化。新しいAPIを発見する探索ツール。

~/Desktop/MAGI システム/_test_auto_dl/tts_api_sniffer.py

クリックして詳細を見る

💬 こう指示すればOK

「セラセンの新しいAPI見つけたい」

「注文データのAPIエンドポイント探って」

📤 こう返ってくる

全API通信ログ（URL, Method, Status）
前回: 92エンドポイント / 1385コール検出

MD

セラセン構造マップ

ナレッジ (.md)

Seller Centerの全ページ構造、92個のAPIエンドポイント、認証フロー（TSP経由必須）、権限状況を網羅。

Claude判断用横展開OK

~/.claude/.../memory/project_tts_seller_center.md

クリックして詳細を見る

🧠 Claudeはこう動く

・TSP→セラセンの認証フローを理解して操作
・92個のAPIカタログから最適なエンドポイントを選択
・権限なしページ（プロモーション/CRM/財務）は回避
・CAPTCHA出現時はユーザーに手動解除を依頼

MD

セラセンAPI検証結果

ナレッジ (.md)

本番で動作確認済みの読み取り専用API一覧。安全フィルタ付き（PUT/DELETE全面禁止）。

Claude判断用

~/.claude/.../memory/project_tts_api_verified.md

クリックして詳細を見る

🧠 Claudeはこう動く

・読み取り専用APIのみ使用（動画/トラフィック/クリエイター/診断）
・PUT/PATCH/DELETE + /edit /update /create /delete /ship /cancel /refund は全面ブロック
・本番クライアントデータを扱うため、誤操作リスクを完全排除

PY

MAGI Bot (bot.py)

常駐スクリプト (.py)

Lark（飛書）でメッセージを受信 → SQLiteにキュー → Claude Codeが分析回答を生成して返信。チームメンバーが自然言語で分析を依頼できる。

常駐プロセス横展開OK

~/Desktop/magi-bot/bot.py

クリックして詳細を見る

💬 こう指示すればOK

「MAGIボット起動して」

「MAGIから小島に分析結果送って」

📤 こう返ってくる

Lark DM or グループチャットに分析回答
テキスト + Lark Docs（長文の場合）

⚠️ 前提条件

.envにLark APP_ID/APP_SECRET設定済み
magi.db（SQLite）が存在
bot.pyがWebSocket常駐で起動中

📅 使用実績

ReFa 週次KPI・動画分析・競合分析の回答
ヤーマン動画成果分析・商品粒度改善

PY

import_to_sqlite.py

スクリプト (.py)

複数クライアントの統合実績管理Excelを一括でSQLiteに取り込む。MAGIが分析するデータベース。

自動実行横展開OK

~/Desktop/MAGI システム/import_to_sqlite.py

クリックして詳細を見る

💬 こう指示すればOK

「統合実績Excelを最新データでDB更新して」

「新しいクライアント（資生堂）をDBに追加して」

📤 こう返ってくる

magi.db にクライアント別テーブル作成/更新
CLIENTSマッピングに追加するだけで新規対応

PY

expand_to_folders.py

スクリプト (.py)

統合実績管理Excelをセラー別・指標別フォルダにCSV展開。MAGIが参照するフォルダ構造を作る。

横展開OK

~/Desktop/MAGI システム/expand_to_folders.py

クリックして詳細を見る

💬 こう指示すればOK

「統合実績をフォルダ構造に展開して」

📤 こう返ってくる

セラー名/指標名/のCSVファイル群
MAGIが分析時に直接参照

MD

MAGI アーキテクチャ

ナレッジ (.md)

MAGIの全体設計。Lark Bot → SQLite → Claude Codeポーリング → 回答生成の流れ。

Claude判断用

~/.claude/.../memory/project_magi_v2_architecture.md

クリックして詳細を見る

🧠 Claudeはこう動く

・Larkメッセージ → SQLite queue → /magi-poll で30秒間隔チェック
・質問に応じてraw/operations/external/のデータを横断分析
・回答をLarkスレッドに返信 + 長文はLark Docsに展開

PY

watch_raw.py

常駐スクリプト (.py)

raw/とexternal/フォルダを監視。新しいファイルが入ったら自動リネーム+macOS通知。

常駐プロセス横展開OK

~/Desktop/ReFa/tools/watch_raw.py

クリックして詳細を見る

💬 こう指示すればOK

「rawフォルダの監視スタートして」

📤 こう返ってくる

常駐監視開始 → 新ファイル検出時にmacOS通知
ファイルは自動リネーム（日付+カテゴリ）

PY

downloads_watcher.py

常駐スクリプト (.py)

~/Downloadsを監視して、FastMossダウンロードファイルを自動で正しいフォルダに振り分け+通知。

常駐プロセス横展開OK

~/Desktop/ReFa/tools/downloads_watcher.py

クリックして詳細を見る

💬 こう指示すればOK

「ダウンロード監視起動して」

📤 こう返ってくる

~/Downloads監視開始
FastMoss Excel検出 → external/の正しいフォルダに自動移動

PY

sort_external.py

スクリプト (.py)

external/直下のファイルをファイル名パターンで自動振り分け。手動整理の手間を省く。

横展開OK

~/Desktop/ReFa/tools/sort_external.py

クリックして詳細を見る

💬 こう指示すればOK

「externalフォルダのファイル整理して」

📤 こう返ってくる

ファイル名パターンで自動振り分け
competitor/seller/, market/ranking/ 等に移動

PY

watcher.py (categories)

常駐スクリプト (.py)

FastMoss Excelの内容を読んでカテゴリ別フォルダに自動振り分け。

常駐プロセス横展開OK

~/Desktop/fastmoss_categories/watcher.py

クリックして詳細を見る

💬 こう指示すればOK

「カテゴリ監視起動して」

📤 こう返ってくる

Excel内容を解析 → ヘアケア/美容家電/バスボディに自動分類

MD

分析フォルダ構造ガイド

ナレッジ (.md)

raw/ operations/ external/ analysis/ の4層フォルダ構造。データの置き場所と分析の進め方のルール。

横展開OK

~/Desktop/ReFa/CLAUDE.md

クリックして詳細を見る

📂 フォルダ構造

raw/ → Seller Centerエクスポート（数値分析の元データ）
operations/ → 施策ログ（何をいつやったか）
external/ → 外部データ（FastMoss等）
analysis/ → 分析アウトプット

新クライアントにはこの構造をコピーしてCLAUDE.mdのセラー名を変更するだけ

MD

Seller Centerデータ定義

スキーマ (.md) x4

Seller Centerからエクスポートしたデータ（ショップ/LIVE/商品/動画）のカラム定義。

横展開OK

~/Desktop/ReFa/raw/{shop,live,product,video}/schema.md

クリックして詳細を見る

📋 4種類のデータ定義

shop/schema.md → ショップ全体指標（GMV, 注文数, CVR）
live/schema.md → LIVE配信データ（視聴者数, GMV, 商品数）
product/schema.md → 商品カード指標（インプレッション, CTR, カート率）
video/schema.md → ショート動画（再生数, クリック数, GMV）

全セラー共通フォーマット

PY

collect_cc.py

スクリプト (.py)

TikTok Creative Centerからハッシュタグインサイト（トレンド・利用数）を自動収集。コンテンツ企画の参考に。

横展開OK

~/Desktop/ReFa/tools/collect_cc.py

クリックして詳細を見る

💬 こう指示すればOK

「#ReFa #ドライヤーのハッシュタグトレンド取って」

「ヤーマン関連のハッシュタグインサイト取得」

📤 こう返ってくる

ハッシュタグ別の利用数・トレンド推移データ
コンテンツ企画の方向性判断に使用

MD

分析テンプレート

テンプレート (.md) x3

月次サマリー・帰属分析・ルーターの3つのテンプレート。分析アウトプットの統一フォーマット。

横展開OK

~/Desktop/ReFa/analysis/_templates/

クリックして詳細を見る

💬 こう指示すればOK

「3月の月次サマリー作って」

「CTRが上がった原因の帰属分析して」

📤 こう返ってくる

テンプレートに沿ったMarkdownレポート
analysis/YYYY-MM_{type}_{scope}.md に保存

MD

帰属分析プロトコル

分析ルール (.md)

指標が変動した時の原因特定ルール。①operations/を先にチェック ②全チャネル横断比較 ③単一原因に帰属しない。

Claude判断用横展開OK

~/Desktop/ReFa/CLAUDE.md (Attribution Protocol)

クリックして詳細を見る

🧠 Claudeはこう動く

Step1: operations/を先にチェック（LIVE実施? SEO変更? 動画投稿? アフィリエイト? プロモ?）
Step2: raw/の全チャネルを横断比較（LIVE/動画/アフィリエイト/ショップ/商品）
Step3: 因果帰属（confirmed / likely / possible / unattributed）
Step4: 市場要因チェック（external/market/で季節性・プラットフォーム変動を排除）

MD

PPTX生成ナレッジ

ナレッジ (.md)

PPTX資料作成のノウハウ。データソース確定方法、フォント規定、スライド構成。

Claude判断用

~/.claude/.../memory/project_refa_pptx.md

クリックして詳細を見る

💬 こう指示すればOK

「市場拡大計画のスライド作って」

「このPPTXの3月データ更新して」

📤 こう返ってくる

.pptxファイル（python-pptxで生成/編集）
16:9白背景、HGP創英角ゴシックUB + Meiryo UI

MD

文体ルール

ナレッジ (.md)

社内向け=カジュアル丁寧、クライアント向け=柔らかい提案トーン。

Claude判断用

~/.claude/.../memory/user_writing_style.md

クリックして詳細を見る

🧠 Claudeはこう動く

社内（Lark/Slack）: 「お疲れ様です！〜完了しました！」カジュアル丁寧
クライアント向け: 「〜という考え方もできるかもしれません」柔らかい提案トーン（断定しない）
CEO向け資料: 控えめ、データ重視、一緒に考えてる感

MD

「できない」と言わない

行動ルール

「できない」と言わず、代替手段・回避策を最初から提案する。

Claude判断用

feedback_proactive_options.md

クリックして詳細を見る

🧠 Claudeはこう動く

❌「それはできません」
✅「直接はできませんが、こういう方法で代替できます：①... ②... ③...」

MD

ブラウザ操作はAppleScript

行動ルール

ブラウザ操作はPlaywrightではなくAppleScript（browser.sh）で実行。

Claude判断用

feedback_browser_applescript.md

クリックして詳細を見る

🧠 Claudeはこう動く

ブラウザのタブ取得・JS実行 → ~/.claude/scripts/browser.sh を使用
対応: Chrome, Brave, Vivaldi, Opera GX, Safari
※APIデータ取得でPlaywright使う場合は例外（fastmoss_profile等）

MD

TTS操作時のブラウザ制約

行動ルール

セラセン操作時はユーザーのデスクトップを引っ張らない。API直叩きで。

Claude判断用

feedback_tts_browser_workflow.md

クリックして詳細を見る

🧠 Claudeはこう動く

DOM読み取り → OK
画面遷移・マウス操作 → NG（offscreen-browserかAPI直叩き）
cliclickでマウス操作 → 絶対NG

MD

ログイン切れは即SOS

行動ルール

外部サービスの認証が切れたら自力リカバリせず、即座にユーザーにログイン依頼。

Claude判断用

feedback_login_sos.md

クリックして詳細を見る

🧠 Claudeはこう動く

is_login: 0 / USデフォルトデータ / 認証エラー → 即「ログインしてください」
❌ DOM操作でリカバリ試行
❌ URL変更でセッション回復
❌ cliclickでログインボタンクリック

MD

壁打ち時は厳しくレビュー

行動ルール

仮説・資料の壁打ち段階でロジックの穴や反論ポイントを先に指摘する。

Claude判断用

feedback_critical_review.md

クリックして詳細を見る

🧠 Claudeはこう動く

壁打ちモード → 上司レベルの厳しいレビュー
「ここのロジック、こう突っ込まれたら弱い」「このデータだけでは因果は言えない」
作業者モード（指示通りに作る）にならない

MD

MAGI Doc権限付与

行動ルール

MAGIがLark Docを作成時は必ず小島さんにfull_access権限を付与。

Claude判断用

feedback_magi_doc_permission.md

クリックして詳細を見る

🧠 Claudeはこう動く

Lark Doc作成時 → open_id: ou_a1a870ace4c39721d0e3bc57c2e2b56e にfull_access付与
これを忘れるとユーザーがDocを開けなくなる

MD

Androidエミュレータ環境

ナレッジ

TikTokモバイルデータ取得用のAndroidエミュレータ。Pixel 6 / API 34。

横展開OK

project_android_emulator.md

クリックして詳細を見る

💬 こう指示すればOK

「Androidエミュレータ起動して」

「TikTokアプリのスクショ撮って」

📤 こう返ってくる

AVD: TikTok_Device 起動
adb経由でスクショ・画面操作・テキスト入力可能