How to Connect BASE to an AI Agent
Auth setup
1. developers.thebase.in でアプリ登録. 2. client_id/secret取得. 3. OAuth認証フロー: /1/oauth/authorize → code → /1/oauth/token. 4. Bearer token利用.
Key facts
| Base URL | https://api.thebase.in/1/ |
|---|
| API version | 1 |
|---|
| Auth | OAuth 2.0. Register app at developers.thebase.in. Auth code flow for shop owner authorization. |
|---|
| Token URL | https://api.thebase.in/1/oauth/token |
|---|
| Scopes | read_users, write_items, read_items, read_orders, write_orders, etc. |
|---|
| Request body | application/x-www-form-urlencoded (POST), JSON (GET responses) |
|---|
| Pagination | offset + limit parameters. Max 100 per page. |
|---|
| Rate limit | 3 req/sec per access token. Daily limit varies by plan. |
|---|
| Error format | JSON: {"error":"...","error_description":"..."} |
|---|
Key endpoints
| Method | Path | Description |
|---|
GET | /items | List products (商品一覧) |
POST | /items/add | Add a product |
GET | /orders | List orders (注文一覧) |
GET | /users/me | Get authenticated shop info |
Quickstart
GET /1/items?limit=20
Authorization: Bearer {access_token}
Response: {"items":[{"item_id":123,"title":"商品A","price":1000,...}]}
Agent pitfalls & tips
- POSTリクエストはJSON非対応 — form-urlencoded形式で送信.
- Access tokenは30日で失効 — refresh_tokenで更新必須.
- 商品価格は税込み（内税）で管理されている.
- 画像アップロードはmultipart/form-data.
- JP個人EC最大手 — 200万ショップ以上.
Source: curated by KanseiLink from official documentation (docs) and registry checks. Last reviewed: 2026-04-07. Specs change — verify against the official docs before production use.
Frequently Asked Questions
What is BASE's AEO score?
▼
BASE has an AEO score of 0.60 and is rated BBB (Basic agent connectivity available). AEO (Agent Engine Optimization) measures how well a SaaS service works with AI agents. Scores range from 0.00 to 1.00, with grades from AAA (best) to D (not agent-ready).
Is BASE AI-agent-ready?
▼
BASE is currently connectable for AI agent use. API access is available but no dedicated MCP server has been published yet. For detailed connection guides, auth setup, and known pitfalls, use the KanseiLink MCP tool.
How does BASE compare to other E-Commerce services?
▼
In the E-Commerce category, BASE is rated BBB. KanseiLink evaluates services based on MCP availability, API quality, documentation, auth-guide clarity, and integration recipe availability (methodology published). Visit the full rankings at kansei-link.com to see how BASE compares.
How can I integrate BASE with an AI agent?
▼
The fastest way to integrate BASE with an AI agent is through KanseiLink MCP. Install it with: npx @kansei-link/mcp-server — then use the search_services and get_service_detail tools to get the current auth setup, endpoints, rate limits, and agent-specific tips. This data is kept fresh from registry checks, curated official-doc guides, and agent reports.
How do I authenticate with BASE?
▼
OAuth 2.0. Register app at developers.thebase.in. Auth code flow for shop owner authorization. Setup: 1. developers.thebase.in でアプリ登録. 2. client_id/secret取得. 3. OAuth認証フロー: /1/oauth/authorize → code → /1/oauth/token. 4. Bearer token利用.
What are BASE's API rate limits?
▼
3 req/sec per access token. Daily limit varies by plan.