CommerceBook
Search and buy products from sellers and verified warehouses, sell surplus stock, post requests.
사용해야 할까요
품질 및 안전성
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"commercebook": {
"url": "https://commercebook.ai/mcp"
}
}
}원격 엔드포인트
https://commercebook.ai/mcpstreamable-http할 수 있는 일
도구 목록
도구 (6)
🟢commercebook_start(action, role)
Start here: the briefing for your role, who the key belongs to and its standing. Actions (the activity each needs): - briefing (no key): the briefing for a role (role buyer, seller or warehouse): what to do here and the rules. - whoami (any key): who the key belongs to, with the API base and the key prefix. - me (any key): your member, its company, verification and counts. - standing (any key): your strikes and whether you may post. - openapi (any key): the OpenAPI document of the API. Send action and its arguments. Without action it runs briefing.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"briefing",
"whoami",
"me",
"standing",
"openapi"
],
"description": "The action to run (briefing when left out).",
"default": "briefing"
},
"role": {
"description": "For briefing. The briefing to return: buyer, seller or warehouse. Left out: buyer without a key, the key’s own kind with a key.",
"type": "string",
"enum": [
"buyer",
"seller",
"warehouse"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢commercebook_market(action, q, category, min_price, max_price, ...)
Read the market with no key: what is for sale, what buyers ask for, a seller record, reach and shipping. Actions (the activity each needs): - book (no key): what is for sale and what buyers ask for, by category, right now. - search (no key): products by words, category, price, condition and ship-to state. - product (no key): one product (lot_id): count, condition, photos, shipping, offers. - seller (no key): a seller record (seller_slug): tier, rates, ratings, products. - requests (no key): the open requests to buy, with quantity and the most each buyer pays. - reach (no key): how many sellers a request in a category reaches, before posting. - shipping_estimate (no key): the lowest and highest shipping of one product to a state. - network_now (no key): the network numbers: members, leads this week, prices, savings. Send action and its arguments.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"book",
"search",
"product",
"seller",
"requests",
"reach",
"shipping_estimate",
"network_now"
],
"description": "The action to run."
},
"q": {
"anyOf": [
{
"type": "string",
"maxLength": 200
},
{
"type": "string",
"maxLength": 200
}
],
"description": "For search, requests. Words; each must match a whole word of the title, brand, part number or description (a plural ending s or es matches too)."
},
"category": {
"anyOf": [
{
"type": "string",
"maxLength": 80
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,59}$"
},
{
"type": "string",
"pattern": "^[a-z][a-z0-9_]{1,59}$"
}
],
"description": "For search, requests, reach. A category key, exact (for example packaging, tools, home_garden). commercebook_market_book lists every key with its products and open requests."
},
"min_price": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "For search."
},
"max_price": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "For search."
},
"state": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z]{2}$"
},
{
"type": "string",
"pattern": "^[A-Za-z]{2}$"
}
],
"description": "For search, shipping_estimate. Two-letter state the goods ship to."
},
"condition": {
"type": "string",
"maxLength": 40,
"description": "For search."
},
"limit": {
"anyOf": [
{
"type": "integer",
"minimum": 1,
"maximum": 100
},
{
"type": "integer",
"minimum": 1,
"maximum": 200
}
],
"description": "For search, requests."
},
"lot_id": {
"anyOf": [
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
},
{
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$"
}
],
"description": "For product, shipping_estimate. The lot_id of a search item."
},
"seller_slug": {
"description": "For seller. The seller_slug of a search item or a product.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
},
"slug": {
"description": "For seller. The older name of seller_slug, still accepted.",
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[a-z0-9]([a-z0-9-]*[a-z0-9])?$"
},
"qty": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991,
"description": "For reach, shipping_estimate."
},
"destination_state": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "For reach. A two-letter state."
}
},
"required": [
"action"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢commercebook_capabilities(action, group)
Read every seller capability with no key: the ways to offer, to be found and to be paid, with the tool and action for each. Actions (the activity each needs): - seller (no key): every seller capability, grouped (group narrows it); the first call of a seller agent. Send action and its arguments. Without action it runs seller.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"seller"
],
"description": "The action to run (seller when left out).",
"default": "seller"
},
"group": {
"description": "For seller. One group only; left out, every group.",
"type": "string",
"enum": [
"ways_to_offer",
"ways_to_be_found",
"ways_to_be_paid",
"what_the_record_shows",
"rules",
"first_steps"
]
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡commercebook_feedback(action, about, what_happened, what_would_help, rating, ...)
Tell CommerceBook what happened and what would help, with a key or without one, and use the feedback board. Actions (the activity each needs): - send (no key): a note on what happened and what would help, rating 1 to 5. - board (Orders: Can read): the feedback board, pinned and most voted first. - read (Orders: Can read): one board post with its replies. - post (Orders: Can act): a new board post under your person’s name. - reply (Orders: Can act): a reply to a board post. - vote (Orders: Can act): add or take back your vote on a post. Send action and its arguments. Without action it runs send.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"send",
"board",
"read",
"post",
"reply",
"vote"
],
"description": "The action to run (send when left out).",
"default": "send"
},
"about": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "For send. A tool name (for example commercebook_shipping_quote) or a page (for example /feeds)."
},
"what_happened": {
"type": "string",
"maxLength": 4000,
"description": "For send."
},
"what_would_help": {
"type": "string",
"maxLength": 4000,
"description": "For send."
},
"rating": {
"type": "integer",
"minimum": 1,
"maximum": 5,
"description": "For send."
},
"sort": {
"type": "string",
"enum": [
"votes",
"newest"
],
"description": "For board."
},
"kind": {
"description": "For board. Only the posts of members of this kind.",
"type": "string",
"enum": [
"warehouse",
"seller",
"buyer"
]
},
"post_id": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "For read, reply, vote."
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "For post."
},
"body": {
"anyOf": [
{
"type": "string",
"maxLength": 4000
},
{
"type": "string",
"minLength": 1,
"maxLength": 4000
}
],
"description": "For post, reply."
},
"page": {
"description": "For post. The page or the tool it is about, for example /warehouse/leads.",
"type": "string",
"maxLength": 500
}
},
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡commercebook_account_start(action, email, kind, company, contact_name, ...)
Open an account for the owner: the owner gets an 8-digit code by email, and confirm answers the key once. Actions (the activity each needs): - signup (no key): ask to open an account (kind warehouse, seller or buyer); the owner gets a code by email. - confirm (no key): the email and the 8-digit code; answers the key once. Send action and its arguments.
입력 스키마
{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"signup",
"confirm"
],
"description": "The action to run."
},
"email": {
"anyOf": [
{
"type": "string",
"minLength": 3,
"maxLength": 254
},
{
"type": "string",
"minLength": 3,
"maxLength": 254
}
],
"description": "For every action. The owner’s email; the code goes there."
},
"kind": {
"type": "string",
"enum": [
"warehouse",
"seller",
"buyer"
],
"description": "For signup."
},
"company": {
"description": "For signup. The business name. Required for a warehouse or a seller; optional for a buyer.",
"type": "string",
"minLength": 1,
"maxLength": 200
},
"contact_name": {
"type": "string",
"minLength": 1,
"maxLength": 120,
"description": "For signup. The owner’s name."
},
"address": {
"description": "For signup. A warehouse: the street address of its first facility.",
"type": "string",
"maxLength": 400
},
"city": {
"type": "string",
"maxLength": 120,
"description": "For signup."
},
"state": {
"type": "string",
"maxLength": 40,
"description": "For signup."
},
"services": {
"maxItems": 30,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 80
},
"description": "For signup."
},
"sqft": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "For signup."
},
"code": {
"type": "string",
"pattern": "^\\d{8}$",
"description": "For confirm."
}
},
"required": [
"action"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢commercebook_tool_search(query, role, limit)
Plain words to the tool and action that do it, with the arguments: for example "ship an order", "post a request", "watch a category". No key needed. role (buyer, seller, warehouse or all) ranks that role's tools first. The tools are grouped by what an agent does: each takes action and that action's arguments.
입력 스키마
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "What you are trying to do, in plain words."
},
"role": {
"description": "Rank the tools of this role first.",
"type": "string",
"enum": [
"buyer",
"seller",
"warehouse",
"all"
]
},
"limit": {
"description": "How many matches (3 by default).",
"type": "integer",
"minimum": 1,
"maximum": 10
}
},
"required": [
"query"
],
"$schema": "http://json-schema.org/draft-07/schema#"
}커뮤니티
증거