margin-analyzer について
margin-analyzer は、中小企業のオーナー向けの価格分析スキルです。コストと取引データから単位経済性を算出し、価格変更のシナリオを示しますが、価格の判断はオーナーに委ねます。
主な機能
- 01コストと売上データの集約
- 02粗利益と単位経済性の算出
- 03業界・過去データによる背景分析
- 04値上げと売上への影響の試算
- 05データ品質上の制約の明示
活用シーン
- 01商品・サービスごとの粗利益の確認
- 025％・10％・15％値上げの比較
- 03過去の取引から販売量と価格変化を分析
- 04コネクターがない場合の CSV データ利用
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/margin-analyzerを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
reference/csv-schema.mdgotchas.mdindustry-benchmarks.mdreference/examples/retail-boutique.mdservice-business.md詳細
マージン分析
ステータス： MVP ドラフト · 担当者： JJ · バージョン： 1.1.0 カテゴリー： 財務・運営 · フェーズ： V2
クイックスタート
中小企業のオーナーから「価格を上げるべきですか？」や「利益率は問題ありませんか？」と聞かれたとき、このスキルは次のことを行います。
- 分析対象を特定します — 対象となる製品・サービスを確認します
- コストデータを取得します — QuickBooks から売上原価（COGS）と直接費を取得します
- 売上データを取得します — PayPal または Square から取引履歴を取得します
- ユニットエコノミクスを算出します — 商品ごとの売上、売上原価、粗利益、利益率を算出します
- 状況に照らしてベンチマークします — 入手可能であれば、インフレ、コストの変化、業界標準と比較します
- 価格シナリオを作成します — データが許す範囲で過去の相関関係を用い、価格を +5%、+10%、+15% 引き上げた場合の売上と利益率を示します
- 分析結果を提示します — 価格の推奨は行わず、判断はオーナーに委ねます
この出力により、オーナーは実データに基づいて自ら価格を判断できます。
ワークフロー
ステップ 1：事前確認
QuickBooks： company-info を呼び出して、業種フィールドに値が入力されていることを確認します。未入力または「Unknown」の場合は、「関連するベンチマークを取得するために、事業カテゴリーが必要です。どの業界に該当しますか？」と尋ねます。その後、quickbooks-profile-info-update を呼び出します。
PayPal： 事前確認は不要ですが、PayPal には短時間の連続呼び出しに対するレート制限があります。reference/gotchas.md を参照してください。
コネクターがない場合： 代替手段として CSV のアップロードを案内します。このスキルは、エクスポートした取引データと経費データを使って分析できます。想定される CSV スキーマは reference/csv-schema.md に記載されています。
ステップ 2：対象範囲の確認
オーナーに次の 2 つの質問をします。
-
「どの製品またはサービスを分析しますか？」
- すべてですか、それとも特定のものに絞りますか？
- 「すべて」と回答した場合は、全件を取得する前に、コネクターに有意な分析を行うのに十分なデータがあることを確認します。
-
「最も重視する指標は何ですか？」
- 粗利益率（売上から直接費を差し引いたもの）ですか？
- 純利益率（すべての経費を差し引いたもの）ですか？
- ユニットあたりの売上ですか？
- 回答に応じて、出力の提示方法を調整します。
ステップ 3：コストデータの取得（QuickBooks）
profit-loss-quickbooks-account を使って QuickBooks から次のデータを取得します。
- 期間： 過去 12 か月分（それより短い期間しかデータがない場合は全履歴）
- 抽出項目： 製品・サービスごとの売上原価と直接費
QuickBooks が接続されていない場合は、オーナーに次の情報を求めます。
- 製品・サービスごとのコスト内訳（品目ごとの材料費、人件費、直接的な提供コスト）
- 過去 6～12 か月の既知のコスト変動
QuickBooks が接続されているものの、すべての期間で COGS = $0 の場合、コスト入力値として $0 を使用しないでください。この点をオーナーに伝えます。
「QuickBooks には、この期間の売上原価が記録されていません。有意義な利益率を算出するには、事業全体の単一の平均値ではなく、製品またはサービスごとのコスト内訳が必要です。分析対象の各品目について、提供にかかるコストを教えてください。材料費、直接人件費、品目ごとの直接経費です。概算でも構いません。」
最終出力の「データ品質に関する注記」セクションに、この制限を記載します。
ステップ 4：売上データの取得（PayPal／Square）
list_transactions（PayPal）または make_api_request（Square）から次のデータを取得します。
- 期間： コストデータの期間に合わせます（過去 12 か月）
- 抽出項目： 取引金額、品目・サービス名、日付、入手可能な場合は数量
PayPal のレート制限に達した場合は、30 秒待ってから一度だけ再試行します。それでもブロックされた場合は、「PayPal は一時的にレート制限されています。Square に切り替えるか、代わりに CSV をアップロードしますか？」と案内します。
データソースが 1 つしか利用できない場合は、出力に制限事項を記載します。
ステップ 5: ユニットエコノミクスを計算する
対象範囲内の各製品・サービスについて、次の項目を計算します。
| 指標 | 計算式 |
|---|---|
| 売上高 | その項目の取引金額の合計 |
| 売上原価 (COGS) | QuickBooks (QB) またはオーナーから提供されたコストデータ |
| 粗利益 | 売上高 − 売上原価 |
| 粗利益率 % | (粗利益 ÷ 売上高) × 100 |
| 販売数量 | 取引件数 (取得可能な場合) |
| 単位あたり売上高 | 売上高 ÷ 販売数量 |
| 単位あたりコスト | 売上原価 ÷ 販売数量 |
利益率が 20% を下回る項目にはフラグを立ててください。これは推奨としてではなく、オーナーが注目する価値のあるデータポイントとして行います。
ステップ 6: ベンチマーク
数値に意味を持たせるために、コンテキストを重ね合わせます。
- インフレ: 投入コストの上昇について論じる場合は、関連するコスト動向に言及します。例: 「この期間中、投入コストは約 X% 上昇した一方で、価格は横ばいでした。そのため利益率が Y ポイント圧縮されました。」
- 業界ベンチマーク: QuickBooks の業界プロファイルを使用して、そのカテゴリの大まかな粗利益率の標準値を提示します。
reference/industry-benchmarks.mdを参照してください。 - 過去との比較: 24 か月以上のデータがある場合は、今年の利益率を昨年と比較して、トレンドの方向性を提示します。
データが少ない場合も適切に対応してください。取引データが 6 か月未満の場合は、弾力性のセクションを省略し、次のように注記します: 「数量が価格変動にどう反応するかを推定するには、少なくとも 6 か月分の価格履歴が必要です。代わりにシナリオの計算をお見せします。」
ステップ 7: 価格シナリオ
各製品・サービスについて、3 つの価格変更シナリオを示す表を作成します。
| シナリオ | 新価格 | 予測売上高* | 粗利益率 % |
|---|---|---|---|
| +5% | $X | $Y | Z% |
| +10% | $X | $Y | Z% |
| +15% | $X | $Y | Z% |
予測売上高の計算方法:
- 6 か月以上の履歴がある場合: 過去データを使用して数量の反応を推定します。過去に価格変更がある場合は、観測された弾力性を計算します:
弾力性 = 数量の変化率 ÷ 価格の変化率。それを新価格での数量予測に適用します。 - 履歴が不十分な場合: 3 つの数量仮定 (−0%、−5%、−10%) を示し、オーナーに現実的と思われるものを選んでもらいます。
次の注記を追加します: 「これらは利用可能なデータに基づく予測であり、保証ではありません。実際の数量の反応は、競合、顧客の価格感度、タイミングによって異なります。」
ステップ 8: 分析を提示する
出力を次のように構成します。
出力は、事業名と対象期間を示す H2 ヘッダーで構成し、 その後に 4 つのセクションを続けます。すなわち、ユニットエコノミクスサマリー表 (製品・サービス、 売上高、売上原価、粗利益、利益率 %)、コンテキストとベンチマークのセクション (インフレ、コスト変動、業界標準に関する 2〜4 文)、価格シナリオ (製品ごとのシナリオ表、多い場合は上位 3〜5 件)、およびデータ品質に関する注記 (部分的なデータ、欠落した売上原価、短い履歴などの制約にフラグを立てる) です。
事実に基づいて記述してください。「値上げすべきです」とか「値下げを検討してください」とは言わないでください。オーナーは自分で判断するためにデータを見ているのです。
スコープの境界
このスキルはデータを提示します。価格を推奨するものではありません。
オーナーが「では、どうすればいいのですか?」と尋ねた場合は、次のように回答してください: 「データが示唆する内容をお見せすることはできますが、価格の決定はオーナーご自身のものです。追加のシナリオをモデル化しましょうか?」
これは意図的なものです。価格の決定には実際のビジネス上の結果が伴い、オーナーだけが知るコンテキスト (競争上のポジショニング、顧客との関係、資金需要) に依存します。このスキルの役割は、オーナーが判断するときに実際の数値を見ていることを確実にすることです。
コネクタ
主要: QuickBooks、PayPal その他対応: Square、Brex · デスクトップ (CSV/エクスポート)
参照ファイル
reference/gotchas.md— よくある落とし穴 (データの欠落、弾力性の罠、利益率の計算ミス)reference/industry-benchmarks.md— SMB カテゴリ別の粗利益率の範囲reference/csv-schema.md— オーナーが CSV をアップロードする際に期待される列reference/examples/— 実践的なシナリオ (小売、サービス、製品ベース)