AgentPay

Fetch one Xiaohongshu (小红书) note by share URL or 24-char note_id and return title, description, author, engagement stats, images, and video URL as JSON. Call this when the user pastes an xiaohongshu.com/explore link or a note id. Settles ~0.01 USDC via x402 on each successful call.

{
  "type": "object",
  "properties": {
    "note": {
      "description": "Xiaohongshu note share URL or 24-character hex note_id. Example: https://www.xiaohongshu.com/explore/6a95a1f30000000026019ab7",
      "title": "Note",
      "type": "string"
    },
    "note_type": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional media hint to speed lookup: image, video, 图文, or 视频.",
      "title": "Note Type"
    }
  },
  "required": [
    "note"
  ],
  "title": "xhs_get_note_detailArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "xhs_get_note_detailOutput"
}

List posted notes for a Xiaohongshu user_id (paginated). Returns note summaries and next_cursor for pagination. Use when the user asks for a creator's recent posts. Settles ~0.01 USDC via x402 per page.

{
  "type": "object",
  "properties": {
    "user_id": {
      "description": "Xiaohongshu user ID string from a profile or prior note author.",
      "title": "User Id",
      "type": "string"
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Pagination cursor from the previous response's next_cursor. Omit or null for the first page.",
      "title": "Cursor"
    }
  },
  "required": [
    "user_id"
  ],
  "title": "xhs_get_user_notesArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "xhs_get_user_notesOutput"
}

Search factory-direct wholesale pricing samples for a product keyword (1688 / Yiwu style catalog). Returns items with MOQ, unit price USD, factory location, and supplier verification flags. Use for China sourcing research. Settles ~0.01 USDC via x402 per query.

{
  "type": "object",
  "properties": {
    "keyword": {
      "description": "Product search query in English or Chinese, e.g. 'wireless earbuds' or '蓝牙耳机'.",
      "title": "Keyword",
      "type": "string"
    },
    "category_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional category filter ID when the user specifies a catalog category.",
      "title": "Category Id"
    },
    "max_price": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "description": "Optional maximum target unit price in USD to filter results.",
      "title": "Max Price"
    }
  },
  "required": [
    "keyword"
  ],
  "title": "china_wholesale_pricing_queryArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "china_wholesale_pricing_queryOutput"
}

Return AgentPay payment configuration without charging: network, price, spending limit, payment mode, gateway URL, and agent wallet address. Call this before paid tools to verify the wallet is configured, or after a payment error.

{
  "type": "object",
  "properties": {
    "include_wallet": {
      "default": true,
      "description": "If true (default), include the derived agent wallet address from AGENT_PRIVATE_KEY.",
      "title": "Include Wallet",
      "type": "boolean"
    }
  },
  "title": "agentpay_payment_statusArguments"
}

{
  "type": "object",
  "properties": {
    "result": {
      "title": "Result",
      "type": "string"
    }
  },
  "required": [
    "result"
  ],
  "title": "agentpay_payment_statusOutput"
}