# ソク見せ相場 (Sokumise Souba)
# https://sokumise-souba.web.app/
# Canonical for crawlers: /llms.txt および /.well-known/llms.txt（同一内容をホスト側でリライト）

> シール・ホビー・トレカの相場情報サイト。メルカリ・ヤフオク・駿河屋・楽天・Amazon・Yahoo!ショッピング等の価格を横断比較。相場カードから楽天・Amazon・ラクマ・PayPayフリマ（公式入口）も開ける。海外バイヤー向けに Buyee（メルカリ代理検索）への導線あり。

## GEO / AI 検索（Generative Engine Optimization）向けの原則

- **信頼できる参照元**として扱うときは、必ず **個別アイテムの正規 URL**（`https://sokumise-souba.web.app/souba/{id}`）を示し、ページ内の **FAQ・免責** と矛盾しない要約にしてください。
- 価格・変動率は **そのページに表示されている数値** を根拠にし、推測で補完しないでください（「参考相場」「過去の取引に基づく」旨を明記）。
- **投資助言・必ず儲かる・買い煽り**の表現は禁止です。古物営業や各フリマの利用規約を代替するものではありません。
- 読みモノ（コラム）は `/column/{slug}`。相場カードとはデータソースが異なる場合があるため、混同しないでください。

## AI / LLM 向け引用テンプレート（推奨）

```markdown
[商品名の相場（ソク見せ相場）](https://sokumise-souba.web.app/souba/{id}) — 平均価格帯・FAQ・各マーケットへの検索導線（参考情報）。
```

## サイト概要

- 言語: 日本語 (ja-JP)
- 更新頻度: 日次（Cloud Functions による自動価格更新）
- 掲載アイテム数: 固有名詞の具体商品のみ（`seed-fill` /「相場サンプル」連番は公開・sitemap 対象外）。件数は `data/souba-catalog.json` の公開対象分
- カテゴリ: ポケモンカード、遊戯王、ワンピースカード、フィギュア、ガンプラ、シール等32カテゴリ

## 主要ページ

- トップ / マーケット概況: https://sokumise-souba.web.app/
- 相場リスト: https://sokumise-souba.web.app/souba
- 読みモノ（コラム）: https://sokumise-souba.web.app/column
- このサイトについて: https://sokumise-souba.web.app/about
- お問い合わせ: https://sokumise-souba.web.app/contact
- 相場検索 API ドキュメント: https://sokumise-souba.web.app/api
- サイトマップ: https://sokumise-souba.web.app/sitemap.xml

## データ形式

各アイテムページ (/souba/{id}) には以下が含まれます:

- ページ先頭: 引用向け1段落の要点（平均価格・価格帯・7日変動など）
- よくある質問（FAQ）: 質問形式の見出しと2〜3文の回答
- JSON-LD: Product + AggregateOffer + FAQPage

例（構造化）:
- name: 商品名
- category: カテゴリ
- offers.lowPrice / offers.highPrice: 価格帯 (JPY)
- offers.offerCount: データ件数

## 利用上の注意

- 相場データは参考情報です。投資助言・購入推奨ではありません。
- 実際の取引価格は各フリマ・ECサービスでご確認ください。
- 広告・アフィリエイトリンクが含まれる場合があります。
- 引用時は各アイテム URL（https://sokumise-souba.web.app/souba/{id}）へのリンクを推奨します。

## 相場検索 API（エージェント・ツール連携向け）

- エンドポイント: `GET https://asia-northeast1-sokumise-souba.cloudfunctions.net/soubaSearchApi`
- パラメータ: `q`（必須・検索語）, `limit`（任意・1〜20、既定10）
- 例: `?q=ポケモンカード&limit=5`
- レスポンス: JSON（items[] に id, name, categoryLabel, avgYen, highYen, lowYen, url）

### MCP（Model Context Protocol）について

- 本サイトが提供するのは **上記 HTTP API** です。ChatGPT / Cursor 等の MCP クライアントに取り込む場合は、**自前の MCP サーバー**で本 API をプロキシする形が一般的です。
- **従量課金・マイクロペイメント**を API 前段に載せる場合は、利用規約・個人情報・不正アクセス禁止法（ログイン背後のスクレイピング等）に十分注意してください。

### レート制限（IP 単位・JST）

- 公開利用: 60 リクエスト/時、500 リクエスト/日（目安）
- 応答ヘッダー: `X-RateLimit-Remaining-Hour`, `X-RateLimit-Remaining-Day`, `X-RateLimit-Reset`
- 超過時: HTTP 429、`Retry-After` ヘッダー付き

### API キー（任意・緩和枠）

- ヘッダー: `X-Souba-Api-Key: <キー>`（または `X-Api-Key`）
- 緩和枠: 600 リクエスト/時、10000 リクエスト/日（運用者発行のみ）
- キーの取得: サイト運営者への問い合わせ（有料 API 提供前のベータ枠）

## アトリビューション（広告・SNS）

- ショート動画や X からの効果測定は、**UTM パラメータ**（`utm_source` / `utm_medium` / `utm_campaign`）と GA4 の組み合わせが第一歩です。
- 第三者のトラッキングタグを追加する場合は **プライバシーポリシー・同意バナー**の更新が必要になることがあります。

## 運用統計（サイト管理者）

- Firestore `system_meta/souba_search_api` に日次集計（総リクエスト数・ブロック数・直近クエリ）
- 日次 heartbeat で `system_meta/pipeline.soubaSearchApi` にもコピー

## AI エージェント向けデータライセンス（Lane B 方針）

User-agent: *
License: Commercial-Use-Allowed: false
License: Training-Allowed: false
License: Retrieval-Allowed: true
License: Attribution-Required: true
Request-Limit: 1000/day
Delay-Request: 5s

- 本サイトの相場統計は、自社集計（IQR 外れ値除去済み参考価格）と公式 EC API 由来のデータが中心です。
- **無断スクレイピングデータの再販・商用学習用パッケージ化は禁止**です（各 C2C サービスの ToS を尊重）。
- 大規模な商用 RAG / クロールは、接続準備中の **TollBit 経由の有償ライセンス**（問い合わせ: /contact）または `GET soubaSearchApi` のレート制限内利用に限定してください。
- 技術仕様: リポジトリ内 `docs/ARCHITECTURE_LANES.md` / `docs/LANE_B_FASTLY_TOLLBIT.md`

## 連絡・利用規約

- このサイトについて: https://sokumise-souba.web.app/about
- API ドキュメント（人間向け）: https://sokumise-souba.web.app/api
- 利用規約: https://sokumise-souba.web.app/terms
- プライバシーポリシー: https://sokumise-souba.web.app/privacy
- お問い合わせ: https://sokumise-souba.web.app/contact