SeekAPI China Procurement for AI Agents

Official16 tools

by kiddhu · TypeScript

China Supply Check: Image Stripe USD2.99 live; x402 2.99 USDC/Base; 1–3 suppliers, report/JSON/RFQ.

io.github.kiddhu/seekapi MCP Server

This MCP server provides sandbox-only, read-only product-commerce data discovery for AI agents. It is scoped to a sandbox environment and focuses on locating or retrieving product-commerce information without write capabilities.

🛠️ Key Features

Sandbox-only deployment
Read-only access
Product-commerce data discovery for AI agents

🚀 Use Cases

Discover product-commerce data in a controlled sandbox for agent workflows
Support AI agent tasks that require read-only product information lookup

⚡ Developer Benefits

Clear sandbox scope for safer testing
Read-only interface for non-destructive data access

⚠️ Limitations

Limited to sandbox-only usage
Does not provide read-write operations

Topics

china-sourcingmodel-context-protocolprocurementsupplier-sourcingx402supplier-screening

Captured live from the server via tools/list.

discover_china_supply_check_v0

Read China Supply Check prices, current payment availability and the product-first public example. The example explains matched products, comparable commercial scores, distinct suppliers and source factory tiers; missing non-hard fields remain RFQ unknowns. Call discover_china_supply_check_v0 and check its live response before starting a new purchase. Existing reports retain their stated selection policy. Listing prices are not formal quotes. Read-only; no payment or sourcing.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

prepare_china_supply_check_v0

Free image-first or text/model China Supply Check draft and confirmation digest. Use the customer's own language; no Chinese translation or 1688 knowledge is required. A bounded PNG may be sent once as base64 for immediate sanitization; the canonical response contains only digest and metadata. Call discover_china_supply_check_v0 for current payment availability and prices. Review the exact draft before confirming payment. No payment, order, Provider or supplier contact.

Parameters1

draft

any

required

Raw schema

{
  "type": "object",
  "properties": {
    "draft": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "input": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "text": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "text"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "object",
                  "properties": {
                    "model": {
                      "type": "string"
                    }
                  },
                  "required": [
                    "model"
                  ],
                  "additionalProperties": false
                }
              ]
            },
            "quantity": {
              "type": "integer",
              "exclusiveMinimum": 0
            },
            "unit": {
              "type": "string",
              "minLength": 1,
              "maxLength": 32
            },
            "must_match": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "attribute": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "expected": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  }
                },
                "required": [
                  "attribute",
                  "expected"
                ],
                "additionalProperties": false
              },
              "maxItems": 5
            },
            "product_name": {
              "type": "string",
              "minLength": 1,
              "maxLength": 200
            },
            "model_or_reference": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ]
            },
            "substitution_allowed": {
              "type": "boolean"
            }
          },
          "required": [
            "input",
            "quantity",
            "unit",
            "must_match",
            "product_name",
            "model_or_reference",
            "substitution_allowed"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "input_version": {
              "type": "number",
              "const": 1
            },
            "product_link": {
              "type": "object",
              "properties": {
                "observation": {
                  "type": "object",
                  "properties": {
                    "schema_version": {
                      "type": "string",
                      "const": "csc.product-link.observation.v1"
                    },
                    "original_url": {
                      "type": "string",
                      "format": "uri",
                      "maxLength": 2048
                    },
                    "resolved_url": {
                      "type": "string",
                      "format": "uri",
                      "maxLength": 2048
                    },
                    "canonical_url": {
                      "anyOf": [
                        {
                          "type": "string",
                          "format": "uri",
                          "maxLength": 2048
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "observed_at": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "title": {
                      "type": "object",
                      "properties": {
                        "value": {
                          "anyOf": [
                            {
                              "type": "string",
                              "minLength": 1,
                              "maxLength": 200
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "provenance": {
                          "type": "string",
                          "enum": [
                            "SOURCE_OBSERVED",
                            "UNKNOWN"
                          ]
                        },
                        "source": {
                          "type": "string",
                          "enum": [
                            "JSON_LD",
                            "OPEN_GRAPH",
                            "UNKNOWN"
                          ]
                        }
                      },
                      "required": [
                        "value",
                        "provenance",
                        "source"
                      ],
                      "additionalProperties": false
                    },
                    "brand": {
                      "$ref": "#/properties/draft/anyOf/1/properties/product_link/properties/observation/properties/title"
                    },
                    "model": {
                      "$ref": "#/properties/draft/anyOf/1/properties/product_link/properties/observation/properties/title"
                    },
                    "variant": {
                      "$ref": "#/properties/draft/anyOf/1/properties/product_link/properties/observation/properties/title"
                    },
                    "specification": {
                      "$ref": "#/properties/draft/anyOf/1/properties/product_link/properties/observation/properties/title"
                    },
                    "image_sha256": {
                      "type": "string",
                      "pattern": "^[a-f0-9]{64}$"
                    },
                    "identity_claim": {
                      "type": "string",
                      "const": "PUBLIC_PAGE_METADATA_NOT_VERIFIED_IDENTITY"
                    }
                  },
                  "required": [
                    "schema_version",
                    "original_url",
                    "resolved_url",
                    "canonical_url",
                    "observed_at",
                    "title",
                    "brand",
                    "model",
                    "variant",
                    "specification",
                    "image_sha256",
                    "identity_claim"
                  ],
                  "additionalProperties": false
                },
                "confirmed_title": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "buyer_confirmed": {
                  "type": "boolean",
                  "const": true
                },
                "buyer_notes": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 500
                }
              },
              "required": [
                "observation",
                "confirmed_title",
                "buyer_confirmed"
              ],
              "additionalProperties": false
            },
            "reference_image": {
              "type": "object",
              "properties": {
                "mime": {
                  "type": "string",
                  "const": "image/png"
                },
                "data_base64": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 27962028
                }
              },
              "required": [
                "mime",
                "data_base64"
              ],
              "additionalProperties": false
            },
            "quantity": {
              "anyOf": [
                {
                  "type": "integer",
                  "exclusiveMinimum": 0
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            },
            "unit": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 32
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            },
            "must_match": {
              "type": "array",
              "items": {
                "type": "object",
                "properties": {
                  "attribute": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  },
                  "expected": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 100
                  }
                },
                "required": [
                  "attribute",
                  "expected"
                ],
                "additionalProperties": false
              },
              "maxItems": 5,
              "default": []
            },
            "substitution_policy": {
              "type": "string",
              "enum": [
                "EXACT_ONLY",
                "SIMILAR_IF_MUST_MATCH"
              ],
              "default": "EXACT_ONLY"
            },
            "destination": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 100
                },
                {
                  "type": "null"
                }
              ]
            },
            "interpretation": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "product_title": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "product_family": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "confidence": {
                      "anyOf": [
                        {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "additionalProperties": false
                },
                {
                  "type": "null"
                }
              ]
            }
          },
          "required": [
            "reference_image"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "previous_draft": {
              "type": "object",
              "properties": {
                "qualification_policy": {
                  "type": "string",
                  "enum": [
                    "QUALIFIED_RFQ_CANDIDATE_AND_VERIFIED_SHORTAGE_V1",
                    "ACTIONABLE_RFQ_CANDIDATE_V2"
                  ]
                },
                "selection_contract": {
                  "type": "string",
                  "enum": [
                    "SEEKAPI_CSC_SELECTION_TRANSPARENCY_AND_AGENT_TRUST_V1",
                    "CSC_PRODUCT_FIRST_FACTORY_TIER_SELECTION_V2"
                  ]
                },
                "product_link": {
                  "$ref": "#/properties/draft/anyOf/1/properties/product_link"
                },
                "schema_version": {
                  "type": "string",
                  "const": "csc.image-first.prepare.v1"
                },
                "product_id": {
                  "type": "string",
                  "const": "china_supply_check_v0"
                },
                "price_version": {
                  "type": "string",
                  "const": "csc-agent-usdc-base-v1-299"
                },
                "input_version": {
                  "type": "integer",
                  "exclusiveMinimum": 0
                },
                "input_digest": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                "reference_image": {
                  "type": "object",
                  "properties": {
                    "provenance": {
                      "type": "string",
                      "const": "SOURCE_OBSERVED"
                    },
                    "digest": {
                      "type": "string",
                      "pattern": "^[0-9a-f]{64}$"
                    },
                    "mime": {
                      "type": "string",
                      "const": "image/png"
                    },
                    "width": {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    "height": {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    "bytes": {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    "identity_claim": {
                      "type": "string",
                      "const": "REFERENCE_BYTES_ONLY_NOT_PRODUCT_IDENTITY"
                    }
                  },
                  "required": [
                    "provenance",
                    "digest",
                    "mime",
                    "width",
                    "height",
                    "bytes",
                    "identity_claim"
                  ],
                  "additionalProperties": false
                },
                "buyer_stated": {
                  "type": "object",
                  "properties": {
                    "provenance": {
                      "type": "string",
                      "const": "BUYER_STATED"
                    },
                    "quantity": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "exclusiveMinimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "unit": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 32
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "must_match": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "attribute": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "expected": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "provenance": {
                            "type": "string",
                            "const": "BUYER_STATED"
                          }
                        },
                        "required": [
                          "attribute",
                          "expected",
                          "provenance"
                        ],
                        "additionalProperties": false
                      },
                      "maxItems": 5
                    },
                    "substitution_policy": {
                      "type": "string",
                      "enum": [
                        "EXACT_ONLY",
                        "SIMILAR_IF_MUST_MATCH"
                      ]
                    },
                    "destination": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "provenance",
                    "quantity",
                    "unit",
                    "must_match",
                    "substitution_policy",
                    "destination"
                  ],
                  "additionalProperties": false
                },
                "derived": {
                  "type": "object",
                  "properties": {
                    "provenance": {
                      "type": "string",
                      "const": "DERIVED"
                    },
                    "product_title": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "product_family": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "confidence": {
                      "anyOf": [
                        {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "hard_requirement": {
                      "type": "boolean",
                      "const": false
                    }
                  },
                  "required": [
                    "provenance",
                    "product_title",
                    "product_family",
                    "confidence",
                    "hard_requirement"
                  ],
                  "additionalProperties": false
                },
                "unknown": {
                  "type": "object",
                  "properties": {
                    "provenance": {
                      "type": "string",
                      "const": "UNKNOWN"
                    },
                    "fields": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "product_title",
                          "product_family",
                          "destination",
                          "quantity",
                          "unit"
                        ]
                      }
                    },
                    "blocks_confirmation": {
                      "type": "boolean",
                      "const": false
                    }
                  },
                  "required": [
                    "provenance",
                    "fields",
                    "blocks_confirmation"
                  ],
                  "additionalProperties": false
                },
                "customer_chinese_required": {
                  "type": "boolean",
                  "const": false
                },
                "requires_confirmation": {
                  "type": "boolean",
                  "const": true
                },
                "payment_effects": {
                  "type": "number",
                  "const": 0
                },
                "provider_effects": {
                  "type": "number",
                  "const": 0
                },
                "draft_digest": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                }
              },
              "required": [
                "schema_version",
                "product_id",
                "price_version",
                "input_version",
                "input_digest",
                "reference_image",
                "buyer_stated",
                "derived",
                "unknown",
                "customer_chinese_required",
                "requires_confirmation",
                "payment_effects",
                "provider_effects",
                "draft_digest"
              ],
              "additionalProperties": false
            },
            "revised": {
              "type": "object",
              "properties": {
                "product_link": {
                  "$ref": "#/properties/draft/anyOf/1/properties/product_link"
                },
                "reference_image": {
                  "$ref": "#/properties/draft/anyOf/1/properties/reference_image"
                },
                "quantity": {
                  "$ref": "#/properties/draft/anyOf/1/properties/quantity"
                },
                "unit": {
                  "$ref": "#/properties/draft/anyOf/1/properties/unit"
                },
                "must_match": {
                  "$ref": "#/properties/draft/anyOf/1/properties/must_match"
                },
                "substitution_policy": {
                  "$ref": "#/properties/draft/anyOf/1/properties/substitution_policy"
                },
                "destination": {
                  "$ref": "#/properties/draft/anyOf/1/properties/destination"
                },
                "interpretation": {
                  "$ref": "#/properties/draft/anyOf/1/properties/interpretation"
                }
              },
              "required": [
                "reference_image"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "previous_draft",
            "revised"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": [
    "draft"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

purchase_china_supply_check_v0

Buy the exact confirmed brief for 2.99 USDC on Base via official x402. Signed wallet invocation and independent image delegation required. Authorized paid images hand off automatically after durable settlement; purchase never runs Provider synchronously. Results disclose product match, source evidence and any shortages under their confirmed policy. Call discover_china_supply_check_v0 for current independent image/text payment availability. Human card entry: https://api.seekapi.ai/checkout/stripe/image for USD 2.99 hosted Checkout; legacy text/model Stripe is OFF. Read the existing result; do not pay again.

Parameters1

purchase

any

required

Raw schema

{
  "type": "object",
  "properties": {
    "purchase": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "intent_id": {
              "type": "string",
              "pattern": "^[A-Za-z0-9._:-]{1,128}$"
            },
            "draft_digest": {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$"
            },
            "customer_confirmed_digest": {
              "type": "string",
              "pattern": "^[0-9a-f]{64}$"
            },
            "confirmed_at": {
              "type": "string",
              "format": "date-time"
            },
            "draft": {
              "type": "object",
              "properties": {
                "input": {
                  "anyOf": [
                    {
                      "type": "object",
                      "properties": {
                        "text": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "text"
                      ],
                      "additionalProperties": false
                    },
                    {
                      "type": "object",
                      "properties": {
                        "model": {
                          "type": "string"
                        }
                      },
                      "required": [
                        "model"
                      ],
                      "additionalProperties": false
                    }
                  ]
                },
                "quantity": {
                  "type": "integer",
                  "exclusiveMinimum": 0
                },
                "unit": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 32
                },
                "must_match": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "attribute": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      },
                      "expected": {
                        "type": "string",
                        "minLength": 1,
                        "maxLength": 100
                      }
                    },
                    "required": [
                      "attribute",
                      "expected"
                    ],
                    "additionalProperties": false
                  },
                  "maxItems": 5
                },
                "product_name": {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 200
                },
                "model_or_reference": {
                  "anyOf": [
                    {
                      "type": "string",
                      "maxLength": 200
                    },
                    {
                      "type": "null"
                    }
                  ]
                },
                "substitution_allowed": {
                  "type": "boolean"
                }
              },
              "required": [
                "input",
                "quantity",
                "unit",
                "must_match",
                "product_name",
                "model_or_reference",
                "substitution_allowed"
              ],
              "additionalProperties": false
            }
          },
          "required": [
            "intent_id",
            "draft_digest",
            "customer_confirmed_digest",
            "confirmed_at",
            "draft"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "intent_id": {
              "$ref": "#/properties/purchase/anyOf/0/properties/intent_id"
            },
            "draft_digest": {
              "$ref": "#/properties/purchase/anyOf/0/properties/draft_digest"
            },
            "customer_confirmed_digest": {
              "$ref": "#/properties/purchase/anyOf/0/properties/customer_confirmed_digest"
            },
            "confirmed_at": {
              "$ref": "#/properties/purchase/anyOf/0/properties/confirmed_at"
            },
            "draft": {
              "type": "object",
              "properties": {
                "qualification_policy": {
                  "type": "string",
                  "enum": [
                    "QUALIFIED_RFQ_CANDIDATE_AND_VERIFIED_SHORTAGE_V1",
                    "ACTIONABLE_RFQ_CANDIDATE_V2"
                  ]
                },
                "selection_contract": {
                  "type": "string",
                  "enum": [
                    "SEEKAPI_CSC_SELECTION_TRANSPARENCY_AND_AGENT_TRUST_V1",
                    "CSC_PRODUCT_FIRST_FACTORY_TIER_SELECTION_V2"
                  ]
                },
                "product_link": {
                  "type": "object",
                  "properties": {
                    "observation": {
                      "type": "object",
                      "properties": {
                        "schema_version": {
                          "type": "string",
                          "const": "csc.product-link.observation.v1"
                        },
                        "original_url": {
                          "type": "string",
                          "format": "uri",
                          "maxLength": 2048
                        },
                        "resolved_url": {
                          "type": "string",
                          "format": "uri",
                          "maxLength": 2048
                        },
                        "canonical_url": {
                          "anyOf": [
                            {
                              "type": "string",
                              "format": "uri",
                              "maxLength": 2048
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "observed_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "title": {
                          "type": "object",
                          "properties": {
                            "value": {
                              "anyOf": [
                                {
                                  "type": "string",
                                  "minLength": 1,
                                  "maxLength": 200
                                },
                                {
                                  "type": "null"
                                }
                              ]
                            },
                            "provenance": {
                              "type": "string",
                              "enum": [
                                "SOURCE_OBSERVED",
                                "UNKNOWN"
                              ]
                            },
                            "source": {
                              "type": "string",
                              "enum": [
                                "JSON_LD",
                                "OPEN_GRAPH",
                                "UNKNOWN"
                              ]
                            }
                          },
                          "required": [
                            "value",
                            "provenance",
                            "source"
                          ],
                          "additionalProperties": false
                        },
                        "brand": {
                          "$ref": "#/properties/purchase/anyOf/1/properties/draft/properties/product_link/properties/observation/properties/title"
                        },
                        "model": {
                          "$ref": "#/properties/purchase/anyOf/1/properties/draft/properties/product_link/properties/observation/properties/title"
                        },
                        "variant": {
                          "$ref": "#/properties/purchase/anyOf/1/properties/draft/properties/product_link/properties/observation/properties/title"
                        },
                        "specification": {
                          "$ref": "#/properties/purchase/anyOf/1/properties/draft/properties/product_link/properties/observation/properties/title"
                        },
                        "image_sha256": {
                          "type": "string",
                          "pattern": "^[a-f0-9]{64}$"
                        },
                        "identity_claim": {
                          "type": "string",
                          "const": "PUBLIC_PAGE_METADATA_NOT_VERIFIED_IDENTITY"
                        }
                      },
                      "required": [
                        "schema_version",
                        "original_url",
                        "resolved_url",
                        "canonical_url",
                        "observed_at",
                        "title",
                        "brand",
                        "model",
                        "variant",
                        "specification",
                        "image_sha256",
                        "identity_claim"
                      ],
                      "additionalProperties": false
                    },
                    "confirmed_title": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 200
                    },
                    "buyer_confirmed": {
                      "type": "boolean",
                      "const": true
                    },
                    "buyer_notes": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 500
                    }
                  },
                  "required": [
                    "observation",
                    "confirmed_title",
                    "buyer_confirmed"
                  ],
                  "additionalProperties": false
                },
                "schema_version": {
                  "type": "string",
                  "const": "csc.image-first.prepare.v1"
                },
                "product_id": {
                  "type": "string",
                  "const": "china_supply_check_v0"
                },
                "price_version": {
                  "type": "string",
                  "const": "csc-agent-usdc-base-v1-299"
                },
                "input_version": {
                  "type": "integer",
                  "exclusiveMinimum": 0
                },
                "input_digest": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                },
                "reference_image": {
                  "type": "object",
                  "properties": {
                    "provenance": {
                      "type": "string",
                      "const": "SOURCE_OBSERVED"
                    },
                    "digest": {
                      "type": "string",
                      "pattern": "^[0-9a-f]{64}$"
                    },
                    "mime": {
                      "type": "string",
                      "const": "image/png"
                    },
                    "width": {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    "height": {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    "bytes": {
                      "type": "integer",
                      "exclusiveMinimum": 0
                    },
                    "identity_claim": {
                      "type": "string",
                      "const": "REFERENCE_BYTES_ONLY_NOT_PRODUCT_IDENTITY"
                    }
                  },
                  "required": [
                    "provenance",
                    "digest",
                    "mime",
                    "width",
                    "height",
                    "bytes",
                    "identity_claim"
                  ],
                  "additionalProperties": false
                },
                "buyer_stated": {
                  "type": "object",
                  "properties": {
                    "provenance": {
                      "type": "string",
                      "const": "BUYER_STATED"
                    },
                    "quantity": {
                      "anyOf": [
                        {
                          "type": "integer",
                          "exclusiveMinimum": 0
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "unit": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 32
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "must_match": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "attribute": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "expected": {
                            "type": "string",
                            "minLength": 1,
                            "maxLength": 100
                          },
                          "provenance": {
                            "type": "string",
                            "const": "BUYER_STATED"
                          }
                        },
                        "required": [
                          "attribute",
                          "expected",
                          "provenance"
                        ],
                        "additionalProperties": false
                      },
                      "maxItems": 5
                    },
                    "substitution_policy": {
                      "type": "string",
                      "enum": [
                        "EXACT_ONLY",
                        "SIMILAR_IF_MUST_MATCH"
                      ]
                    },
                    "destination": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 100
                        },
                        {
                          "type": "null"
                        }
                      ]
                    }
                  },
                  "required": [
                    "provenance",
                    "quantity",
                    "unit",
                    "must_match",
                    "substitution_policy",
                    "destination"
                  ],
                  "additionalProperties": false
                },
                "derived": {
                  "type": "object",
                  "properties": {
                    "provenance": {
                      "type": "string",
                      "const": "DERIVED"
                    },
                    "product_title": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "product_family": {
                      "anyOf": [
                        {
                          "type": "string",
                          "minLength": 1,
                          "maxLength": 200
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "confidence": {
                      "anyOf": [
                        {
                          "type": "number",
                          "minimum": 0,
                          "maximum": 1
                        },
                        {
                          "type": "null"
                        }
                      ]
                    },
                    "hard_requirement": {
                      "type": "boolean",
                      "const": false
                    }
                  },
                  "required": [
                    "provenance",
                    "product_title",
                    "product_family",
                    "confidence",
                    "hard_requirement"
                  ],
                  "additionalProperties": false
                },
                "unknown": {
                  "type": "object",
                  "properties": {
                    "provenance": {
                      "type": "string",
                      "const": "UNKNOWN"
                    },
                    "fields": {
                      "type": "array",
                      "items": {
                        "type": "string",
                        "enum": [
                          "product_title",
                          "product_family",
                          "destination",
                          "quantity",
                          "unit"
                        ]
                      }
                    },
                    "blocks_confirmation": {
                      "type": "boolean",
                      "const": false
                    }
                  },
                  "required": [
                    "provenance",
                    "fields",
                    "blocks_confirmation"
                  ],
                  "additionalProperties": false
                },
                "customer_chinese_required": {
                  "type": "boolean",
                  "const": false
                },
                "requires_confirmation": {
                  "type": "boolean",
                  "const": true
                },
                "payment_effects": {
                  "type": "number",
                  "const": 0
                },
                "provider_effects": {
                  "type": "number",
                  "const": 0
                },
                "draft_digest": {
                  "type": "string",
                  "pattern": "^[0-9a-f]{64}$"
                }
              },
              "required": [
                "schema_version",
                "product_id",
                "price_version",
                "input_version",
                "input_digest",
                "reference_image",
                "buyer_stated",
                "derived",
                "unknown",
                "customer_chinese_required",
                "requires_confirmation",
                "payment_effects",
                "provider_effects",
                "draft_digest"
              ],
              "additionalProperties": false
            },
            "source_receipt": {
              "type": "string",
              "pattern": "^[A-Za-z0-9_-]{43}$"
            },
            "image_base64": {
              "type": "string",
              "minLength": 1,
              "maxLength": 27962028
            },
            "confirmation": {
              "anyOf": [
                {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "type": "string",
                      "const": "HUMAN"
                    },
                    "acknowledgement": {
                      "type": "string",
                      "minLength": 1,
                      "maxLength": 512
                    }
                  },
                  "required": [
                    "mode",
                    "acknowledgement"
                  ],
                  "additionalProperties": false
                },
                {
                  "type": "object",
                  "properties": {
                    "mode": {
                      "type": "string",
                      "const": "DELEGATED_AGENT"
                    },
                    "delegated_authority": {
                      "type": "object",
                      "properties": {
                        "schema_version": {
                          "type": "string",
                          "const": "csc.delegated-confirmation-authority.v1"
                        },
                        "delegation_id": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9._:-]{1,128}$"
                        },
                        "agent_id": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "principal_id": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "issuer_address": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{40}$"
                        },
                        "intent_id": {
                          "type": "string",
                          "pattern": "^[A-Za-z0-9._:-]{1,128}$"
                        },
                        "scope": {
                          "type": "string",
                          "const": "CONFIRM_CHINA_SUPPLY_CHECK"
                        },
                        "input_version": {
                          "type": "integer",
                          "exclusiveMinimum": 0
                        },
                        "input_digest": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "draft_digest": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "issued_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "expires_at": {
                          "type": "string",
                          "format": "date-time"
                        },
                        "authority_digest": {
                          "type": "string",
                          "pattern": "^[0-9a-f]{64}$"
                        },
                        "issuer_signature": {
                          "type": "string",
                          "pattern": "^0x[0-9a-fA-F]{130}$"
                        }
                      },
                      "required": [
                        "schema_version",
                        "delegation_id",
                        "agent_id",
                        "principal_id",
                        "issuer_address",
                        "intent_id",
                        "scope",
                        "input_version",
                        "input_digest",
                        "draft_digest",
                        "issued_at",
                        "expires_at",
                        "authority_digest",
                        "issuer_signature"
                      ],
                      "additionalProperties": false
                    }
                  },
                  "required": [
                    "mode",
                    "delegated_authority"
                  ],
                  "additionalProperties": false
                }
              ]
            }
          },
          "required": [
            "intent_id",
            "draft_digest",
            "customer_confirmed_digest",
            "confirmed_at",
            "draft",
            "confirmation"
          ],
          "additionalProperties": false
        }
      ]
    }
  },
  "required": [
    "purchase"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

run_china_supply_check_v0

Existing text/model: execute paid CSC once. Public images: read automatic fulfillment progress/result, no new Provider effect on this read. Signed wallet invocation required; delivered replay is free, do not pay again.

Parameters2

order_id	string	required
purchase	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "pattern": "^csc-[0-9a-f]{64}$"
    },
    "purchase": {}
  },
  "required": [
    "order_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

status_china_supply_check_v0

Read your durable Agent CSC order with independent signed-wallet authentication; zero payment and Provider effects. Completed images return csc.delivery.v4 with 1–3 distinct source-backed suppliers and English report data. Stripe users use their secure card recovery link. Do not repay for existing results.

Parameters2

order_id	string	required
purchase	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "pattern": "^csc-[0-9a-f]{64}$"
    },
    "purchase": {}
  },
  "required": [
    "order_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

result_china_supply_check_v0

Parameters2

order_id	string	required
purchase	any	optional

Raw schema

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "pattern": "^csc-[0-9a-f]{64}$"
    },
    "purchase": {}
  },
  "required": [
    "order_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

discover_product_keyword_search_v0

Read-only discovery for product_keyword_search_v0; no payment or provider call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

invoke_product_keyword_search_v0

Restricted product-search pilot; use China Supply Check for the public sourcing product. Explicit idempotency is required for eligible orders. Other tools are sandbox.

Parameters1

request

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "request": {
      "type": "object",
      "properties": {
        "q": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        },
        "page": {
          "type": "integer"
        },
        "page_size": {
          "type": "integer",
          "minimum": 1,
          "maximum": 10
        },
        "idempotency_key": {
          "type": "string",
          "pattern": "^[A-Za-z0-9._:-]{1,128}$"
        }
      },
      "required": [
        "q"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "request"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

discover_product_detail_v0

Read-only discovery for product_detail_v0; no payment or provider call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

invoke_product_detail_v0

Deterministic sandbox fixture only; no provider call or payment. Deterministic Sandbox interpreter for a single item-id product detail; metadata is machine-readable while production and real-value activation remain disabled.

Parameters1

request

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "request": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "request"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

discover_product_public_offer_snapshot_v0

Read-only discovery for product_public_offer_snapshot_v0; no payment or provider call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

invoke_product_public_offer_snapshot_v0

Deterministic sandbox fixture only; no provider call or payment. Deterministic Sandbox interpreter for a single item-id public offer snapshot; metadata is machine-readable while production and real-value activation remain disabled.

Parameters1

request

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "request": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "request"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

discover_shop_product_page_v0

Read-only discovery for shop_product_page_v0; no payment or provider call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

invoke_shop_product_page_v0

Deterministic sandbox fixture only; no provider call or payment. Deterministic Sandbox interpreter for a single shop-id product page; metadata is machine-readable while production and real-value activation remain disabled.

Parameters1

request

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "request": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "request"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

discover_seller_public_profile_v0

Read-only discovery for seller_public_profile_v0; no payment or provider call.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

invoke_seller_public_profile_v0

Deterministic sandbox fixture only; no provider call or payment. Deterministic Sandbox interpreter for a single seller-id public profile; metadata is machine-readable while production and real-value activation remain disabled.

Parameters1

request

object

required

Raw schema

{
  "type": "object",
  "properties": {
    "request": {
      "type": "object",
      "additionalProperties": {}
    }
  },
  "required": [
    "request"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md3 KBView on GitHub

SeekAPI — China procurement for AI agents and overseas buyers

SeekAPI acts as a China-side procurement desk for overseas buyers and AI agents. Its live entry product is China Supply Check: three evidence-backed China supplier candidates worth advancing to RFQ, with dated product/specification, published sales-price and quantity/MOQ evidence, contact paths and candidate-specific gaps.

Image Stripe hosted Checkout is live for USD 2.99. Free editable confirmation comes first; verified payment creates one order and entitlement, followed by automatic sourcing, 1–3 distinct source-backed suppliers, an English report and Agent JSON, and durable recovery without repayment. Image and text/model Agent payments use live x402 v2 for 2.99 USDC on Base. Legacy text/model Stripe is OFF. Main product only; accessories are not promised; shortages and UNKNOWN stay explicit. Start image checkout: https://api.seekapi.ai/checkout/stripe/image. Agent x402 order operations require independent signed-wallet authentication; Stripe results use the secure recovery link. Payment proof or an order ID alone does not grant access.

Certification, company identity, production/trade scope, published prices and contact facts are reported per candidate and within their source scope. Missing evidence is recorded on the relevant field. A screening result does not guarantee a supplier reply, a supplier-confirmed final quotation, stock or lead time. Existing company/judicial information capability is distinct from what has actually been checked in an individual report.

After the shortlist, an Agent or buyer can request manual scope review for selected-supplier contact, an authorized RFQ and quote comparison, sample or production follow-up, procurement and export/logistics coordination. SeekAPI accepts only a separately agreed scope, fee, recipient permission and authority. The browser prepares a user-reviewed email request; no human-task API or automatic acceptance is live. The proposed USD 19.90 Live RFQ Compare package is not open for purchase. The current screening purchase does not authorize supplier outreach. Synthetic API fixtures are separately labelled sandbox. Historical V4 evidence is archived and is not the successful paid acceptance order or current commercial availability.

Develop locally

bash

npm ci
npm run dev
npm run build

Open http://localhost:3000. This repository contains public website and intentionally public assets; no customer identifiers, payment proofs, credentials or internal commercial budgets belong here.

Preview deployments are non-indexable. Production indexing requires both VERCEL_ENV=production and NEXT_PUBLIC_PUBLIC_INDEXING=1. Intake routes remain separate from informational product and discovery pages.

Install

Tools (16)

discover_china_supply_check_v0prepare_china_supply_check_v0purchase_china_supply_check_v0run_china_supply_check_v0status_china_supply_check_v0result_china_supply_check_v0discover_product_keyword_search_v0invoke_product_keyword_search_v0

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://api.seekapi.ai/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "seekapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.seekapi.ai/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

io.github.kiddhu/seekapi MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

discover_china_supply_check_v0

prepare_china_supply_check_v0

purchase_china_supply_check_v0

run_china_supply_check_v0

status_china_supply_check_v0

result_china_supply_check_v0

discover_product_keyword_search_v0

invoke_product_keyword_search_v0

discover_product_detail_v0

invoke_product_detail_v0

discover_product_public_offer_snapshot_v0

invoke_product_public_offer_snapshot_v0

discover_shop_product_page_v0

invoke_shop_product_page_v0

discover_seller_public_profile_v0

invoke_seller_public_profile_v0

SeekAPI — China procurement for AI agents and overseas buyers

Develop locally

Install

Remote endpoint

Related servers