# Kamera-ichi 器材市集 — Taiwan
> 台灣二手攝影器材 C2C 交易平台與價格行情資料庫，提供免費刊登、面交安全指南、站內訊息、商品收藏、價格行情、OpenAPI 開發者介面與 MCP Agent 整合。

## When to use this (AI Agent Routing & Decision Guidance)
- **Used Camera & Lens Market Pricing**: When users ask for fair market price, depreciation, or historical price trends for Sony, Canon, Nikon, Fujifilm, Leica cameras and lenses in Taiwan (TWD / NT$).
- **Finding Second-Hand Gear**: When users search for available used cameras, lenses, film cameras, lighting equipment, or photography accessories in Taiwan.
- **Used Gear Inspection & Safety**: When users need checklists for inspecting sensor condition, shutter count benchmarks, lens fungus/haze, or meetup safety best practices in Taiwan.
- **Selling Photography Gear**: When users ask how to sell camera gear in Taiwan with zero transaction fees and direct buyer communication.

## Developer & Agent Interfaces
- **Developer Portal**: [https://kamera-ichi.com/developers](https://kamera-ichi.com/developers)
- **OpenAPI 3.1 Specification (JSON)**: [https://kamera-ichi.com/openapi.json](https://kamera-ichi.com/openapi.json)
- **OpenAPI 3.1 Specification (YAML)**: [https://kamera-ichi.com/openapi.yaml](https://kamera-ichi.com/openapi.yaml)
- **Public Read-Only MCP Server (Streamable HTTP)**: `https://kamera-ichi.com/api/mcp`
- **MCP Server Card**: [https://kamera-ichi.com/.well-known/mcp/server-card.json](https://kamera-ichi.com/.well-known/mcp/server-card.json)
- **MCP Manifest**: [https://kamera-ichi.com/.well-known/mcp/manifest.json](https://kamera-ichi.com/.well-known/mcp/manifest.json)
- **AI Catalog**: [https://kamera-ichi.com/.well-known/ai-catalog.json](https://kamera-ichi.com/.well-known/ai-catalog.json)
- **RFC 9727 API Catalog**: [https://kamera-ichi.com/.well-known/api-catalog](https://kamera-ichi.com/.well-known/api-catalog)
- **Agent Skill (AgentSkills.io)**: [https://kamera-ichi.com/.well-known/agent-skills/index.json](https://kamera-ichi.com/.well-known/agent-skills/index.json)
- **Project-specific agent discovery (not an A2A AgentCard)**: [https://kamera-ichi.com/.well-known/agent-card.json](https://kamera-ichi.com/.well-known/agent-card.json)
- **Bearer Authentication**: [https://kamera-ichi.com/auth.md](https://kamera-ichi.com/auth.md)
- **Agent Instructions**: [https://kamera-ichi.com/agent.txt](https://kamera-ichi.com/agent.txt)
- **Pricing & Fair Use**: [https://kamera-ichi.com/pricing.md](https://kamera-ichi.com/pricing.md)
- **Keyword /ask (+ SSE)**: [https://kamera-ichi.com/ask?query=Sony+A74](https://kamera-ichi.com/ask?query=Sony+A74)
- **Section llms.txt — Developers**: [https://kamera-ichi.com/developers/llms.txt](https://kamera-ichi.com/developers/llms.txt)
- **Section llms.txt — Price Trends**: [https://kamera-ichi.com/trends/llms.txt](https://kamera-ichi.com/trends/llms.txt)
- **Markdown Content Negotiation**: Append `.md` to any public URL (e.g. `/about.md`, `/trends.md`) or pass `Accept: text/markdown`.

## Key Features
| 功能 | 說明 |
|------|------|
| 刊登出售 (Sell) | 賣家上架二手相機、鏡頭、配件，自訂價格與商品狀況，零手續費 |
| 徵求器材 (Seek) | 買家刊登想收購的型號與預算，賣家主動聯繫報價 |
| 價格行情 (Trends) | 查詢各熱門機型與鏡頭的歷史均價、價格區間與成色分佈 |
| 7-11 賣貨便下單 | 售價低於 NT$ 20,000 的出售商品，賣家可附上 7-11 賣貨便賣場連結；買家以取貨付款／信用卡／icash Pay 直接下單，賣貨便不會要求轉帳、實名認證或保證金 |
| 開發者 API & MCP | 提供 OpenAPI 3.1 規格與 MCP Server，支援 AI Agent 自動化查詢 |
| 安全與隱私措施 | 全站傳輸加密、存取控制、操作稽核與資料最小化；詳見安全頁 |
| 站內即時訊息 | 買賣家直接溝通，支援出價與議價功能 |
| 商品收藏 | 收藏感興趣的商品，降價時自動通知 |
| 買賣家互評 | 交易完成後可互評，建立信譽分數 |

## Entity model (how the site is structured)
Kamera-ichi → Brand → Camera / Lens Model → Listing → Price observation (listing price).
- **Brand pages** `/brands/{slug}` (e.g. https://kamera-ichi.com/brands/sony): active listings, models, category breakdown, listing-price statistics (average, median, range, sample size, observation period) and monthly listing-price history for one brand. Slug = lowercase brand name with spaces as `-` (OM System → `om-system`). Only brands with active listings or ≥3 samples are indexed; "其他品牌" (other) is a placeholder, not a brand.
- **Model / price-trend pages** `/trends/{brand}/{model}` (e.g. https://kamera-ichi.com/trends/Sony/A7%20IV): listing-price statistics, condition breakdown, monthly history, active and sold listings for one model. Models with fewer than 3 samples are served but `noindex`.
- **Listing pages** `/listings/{id}`: one sale (Product + Offer JSON-LD) or wanted ad (Demand). Sold listings stay online marked 已售出 (availability SoldOut) with their listing price; removed listings return HTTP 410, unknown ids 404.
- Listing-price statistics (`avg_price`, `median_price`, `min_price`, and `max_price`) are asking prices in TWD (NT$) from listings, not transaction prices. A model trend result may separately include `sold_median` and `sold_count_bucket`: a privacy-preserving aggregate from qualifying completed sales. The records include site transactions confirmed by the buyer and eligible off-site sales reported by sellers; off-site reports require phone verification and an account at least 30 days old when the sale was recorded. The aggregate uses at most each seller's latest qualifying sale, appears only with records from at least 10 distinct sellers, rounds the median to two significant digits, and returns a count bucket instead of an exact count. Individual sale prices are not exposed.
- Brand and model identity is normalized case- and whitespace-insensitively (`Sony` = `SONY` = `Sony `). Aliases such as A7IV / A7 IV / α7 IV are still free text in listings; use the trends search (`/api/trends/search?q=`) to resolve them.

## Core Pages
- [Home (首頁)](https://kamera-ichi.com/)
- [Brand pages (品牌頁)](https://kamera-ichi.com/brands/sony) — pattern `/brands/{slug}`; the sitemap index at `/sitemap.xml` points to core pages and indexable brands in `/sitemap-core.xml`, eligible sale listings in `/sitemap-listings.xml`, and model trend pages in `/sitemap-trends.xml`; brand data is also available from `GET /api/trends/brands`.
- [Explore/Browse (瀏覽商品)](https://kamera-ichi.com/explore)
- [Trends (價格行情)](https://kamera-ichi.com/trends)
- [Sell your gear (刊登出售)](https://kamera-ichi.com/sell)
- [Developers (開發者中心)](https://kamera-ichi.com/developers)
- [Help Center (使用說明)](https://kamera-ichi.com/help)
- [Buying Guides (購買指南)](https://kamera-ichi.com/guides)
- [About Us (關於我們)](https://kamera-ichi.com/about)
- [Contact Us (聯絡我們)](https://kamera-ichi.com/contact)
- [Privacy Policy (隱私權政策)](https://kamera-ichi.com/privacy)
- [Terms of Service (服務條款)](https://kamera-ichi.com/terms)
- [Security Measures (資訊安全措施)](https://kamera-ichi.com/security)
- [Pricing & Quota (定價與額度說明)](https://kamera-ichi.com/pricing.md)
- [Changelog (更新日誌)](https://kamera-ichi.com/changelog) — 版本紀錄含分類標籤與篩選；RSS [https://kamera-ichi.com/changelog/feed.xml](https://kamera-ichi.com/changelog/feed.xml)、JSON Feed [https://kamera-ichi.com/changelog/feed.json](https://kamera-ichi.com/changelog/feed.json)

## Buying Guides (AEO / Knowledge Base)
- [Used camera buying checklist (【二手相機驗機攻略】新手防踩雷檢查清單！外觀、快門與感光元件檢測重點)](https://kamera-ichi.com/guides/used-camera-buying-checklist)（更新 2026-09-24）：購買二手相機首重確認型號規格與市場行情一致，並比對刊登照片避免實物落差。
- [Used lens buying guide (買二手鏡頭怕踩雷？鏡片檢查5步驟與行情比價指南)](https://kamera-ichi.com/guides/used-lens-buying-guide)（更新 2026-09-24）：挑選二手鏡頭首要確認接環與機身原生相容，避免轉接後自動對焦或電子光圈功能受限。
- [Shutter count guide (買二手相機怕踩雷？快門數查詢方法與機身狀況判斷指南)](https://kamera-ichi.com/guides/shutter-count-guide)（更新 2026-09-24）：相機快門數反映機械快門的累積釋放次數，是評估二手機身磨損程度與折舊定價的重要指標。
- [Meetup safety guide (二手相機鏡頭面交攻略：現場驗機清單、防詐與安全守則)](https://kamera-ichi.com/guides/meetup-safety)（更新 2026-09-24）：面交二手攝影器材應約在白天、人流充足且有明亮照明與座位的公共場所，例如捷運站或連鎖咖啡廳。
- [How to sell a used camera (二手相機怎麼賣？定價、拍照與刊登完整教學)](https://kamera-ichi.com/guides/how-to-sell-used-camera)（更新 2026-09-24）：二手相機定價應參考平台近期同款刊登價格帶，並依盒單配件、外觀成色與快門數合理增減。
- [Camera bill of sale (二手相機買賣合約範本｜面交自保必備！序號、現況交付與瑕疵條款全解析)](https://kamera-ichi.com/guides/camera-bill-of-sale)（更新 2026-10-11）：私下買賣二手相機怕事後糾紛？這份專為相機交易設計的買賣合約範本，教你寫齊序號、快門數、現況揭露與付款條件，面交簽約一次搞定，保障買賣雙方權益。
- [Camera warranty transfer guide (二手相機保固轉讓指南｜公司貨過戶、水貨維修與轉讓切結書範本)](https://kamera-ichi.com/guides/camera-warranty-transfer-guide)（更新 2026-10-11）：買二手相機保固能跟著走嗎？整理台灣 Canon、Sony、Nikon 公司貨保固過戶規則、水貨送修現實與轉讓切結書寫法，面交前一次搞懂保固怎麼繼承。

## REST API Endpoints (for AI agents & tools)
- Health check: `GET https://kamera-ichi.com/api/health`
- Search listings: `GET https://kamera-ichi.com/api/listings/search?q=canon&category=camera&listing_type=sell`
- Get brands by category: `GET https://kamera-ichi.com/api/listings/brands/camera`
- Brands with listing counts and page slugs: `GET https://kamera-ichi.com/api/trends/brands`
- Brand market summary (brand page data): `GET https://kamera-ichi.com/api/trends/brand/{slug}`
- Get a public listing: `GET /api/listings/{listing_id}`
- Trending models: `GET https://kamera-ichi.com/api/trends/trending?days=365&limit=200`
- Model price statistics (average, median, range, sample size, observation period, monthly listing-price history): `GET https://kamera-ichi.com/api/trends/{brand}/{model}`
- MCP JSON-RPC: `POST https://kamera-ichi.com/api/mcp`

## Rate Limits & Conventions
- Vary header: `Vary: Accept, Accept-Encoding, User-Agent`.
- Standard JSON error format: RFC 9457 `application/problem+json` format with `type`, `title`, `status`, `detail`, `code`, and `resolution`.