# 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)
- **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)
- **RFC 9728 Protected Resource**: [https://kamera-ichi.com/.well-known/oauth-protected-resource](https://kamera-ichi.com/.well-known/oauth-protected-resource)
- **Agent Skill (AgentSkills.io)**: [https://kamera-ichi.com/.well-known/agent-skills/index.json](https://kamera-ichi.com/.well-known/agent-skills/index.json)
- **A2A Agent Card**: [https://kamera-ichi.com/.well-known/agent-card.json](https://kamera-ichi.com/.well-known/agent-card.json)
- **Authentication & Scopes**: [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)
- **Sandbox (no auth)**: [https://kamera-ichi.com/api/sandbox](https://kamera-ichi.com/api/sandbox)
- **NLWeb /ask (natural language + 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) | 查詢各熱門機型與鏡頭的歷史均價、價格區間與成色分佈 |
| 開發者 API & MCP | 提供 OpenAPI 3.1 規格與 MCP Server，支援 AI Agent 自動化查詢 |
| 安全與隱私措施 | 全站傳輸加密、存取控制、操作稽核與資料最小化；詳見安全頁 |
| 站內即時訊息 | 買賣家直接溝通，支援出價與議價功能 |
| 商品收藏 | 收藏感興趣的商品，降價時自動通知 |
| 買賣家互評 | 交易完成後可互評，建立信譽分數 |

## Core Pages
- [Home (首頁)](https://kamera-ichi.com/)
- [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)

## Buying Guides (AEO / Knowledge Base)
- [Used camera buying checklist (二手相機購買檢查清單)](https://kamera-ichi.com/guides/used-camera-buying-checklist)：外觀、感光元件、快門與功能檢查重點。
- [Used lens buying guide (二手鏡頭挑選指南)](https://kamera-ichi.com/guides/used-lens-buying-guide)：接環相容性、鏡片鍍膜發霉檢查與實拍確認。
- [Shutter count guide (相機快門數指南)](https://kamera-ichi.com/guides/shutter-count-guide)：快門數意義、查詢方式與二手折舊評估。
- [Meetup safety guide (二手攝影器材面交安全指南)](https://kamera-ichi.com/guides/meetup-safety)：公共場所面交、驗貨付款與防詐通報。

## 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`
- 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: `GET https://kamera-ichi.com/api/trends/{brand}/{model}`
- MCP JSON-RPC: `POST https://kamera-ichi.com/api/mcp`

## Rate Limits & Conventions
- Standard rate limit: 100 requests per minute per IP.
- Standard RFC headers returned: `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset`, `RateLimit-Policy`.
- 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`.