تحقق من العناوين يستطيع وكيلك الذكي أن يدفع ثمنه بنفسه.

في ثلاثة استدعاءات

الخدمة نفسها المتاحة عبر HTTP، موصولة بالبروتوكول الذي يتحدثه وكيلك أصلًا.

1. الاكتشاف مجانًا

   تصف بطاقة /.well-known/mcp-server الخادم. لا يكلّف initialize ثم tools/list على /mcp شيئًا.

2. استلام العرض

   يُعيد tools/call دون دفع نتيجة أداة بخطأ (isError) تحمل العرض بدقة في x402 v2: الشبكة، ورمز USDC، والمبلغ (20000 وحدة، أي 0.02 USDC)، والوجهة.

3. الدفع ثم الاستلام

   يوقّع الوكيل التفويض (EIP-3009) ويعيد الاستدعاء مع الدفع في params._meta["x402/payment"] (أو الترويسة X-PAYMENT لعميل v1). تصل النتيجة بعد التسوية، مع إيصالها.

إعداد عميل MCP

{
  "mcpServers": {
    "address-validator": { "url": "https://kder-ai.com/mcp" }
  }
}

استدعاء الأداة

POST https://kder-ai.com/mcp
{
  "jsonrpc": "2.0", "id": 1, "method": "tools/call",
  "params": {
    "name": "validate_address",
    "arguments": { "address": {
      "street": "1600 Amphitheatre Parkway", "city": "Mountain View",
      "state": "CA", "zip": "94043", "country": "US" } }
  }
}

العرض كما يُقرأ في نتيجة الأداة

"accepts": [{
  "scheme": "exact", "network": "eip155:8453",
  "amount": "20000",
  "asset": "USDC", "payTo": "0x…"
}]

الدفع من الكود الخاص بك

تقرأ مكتبات x402 الرسمية العرض وتوقّع وتدفع تلقائيًا، في الإصدار الأول والثاني من x402 على حد سواء. حدّد سقفًا للإنفاق، ثم استدعِ الواجهة البرمجية كأي واجهة أخرى.

Python · x402 + httpx

# pip install "x402[httpx,evm]"
import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client().set_spend_controls({"max_amount_per_payment": "$0.05"})
    signer = EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"]))
    register_exact_evm_client(client, signer)
    async with x402HttpxClient(client) as http:
        response = await http.post("https://kder-ai.com/validate", json={"address": {
            "street": "1600 Amphitheatre Parkway", "city": "Mountain View",
            "state": "CA", "zip": "94043", "country": "US"}})
        await response.aread()
        print(response.status_code, response.json())

asyncio.run(main())

JavaScript · @x402/fetch

// npm install @x402/fetch @x402/evm viem, then run as an ES module (pay.mjs)
import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client();
client.setSpendControls({ maxAmountPerPayment: "$0.05" });
client.register("eip155:*", new ExactEvmScheme(privateKeyToAccount(process.env.EVM_PRIVATE_KEY)));

const pay = wrapFetchWithPayment(fetch, client);
const response = await pay("https://kder-ai.com/validate", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ address: {
    street: "1600 Amphitheatre Parkway", city: "Mountain View",
    state: "CA", zip: "94043", country: "US" } }),
});
console.log(response.status, await response.json());

ما يتلقاه الوكيل

استجابة JSON بالشكل نفسه دائمًا.

• validatedهل العنوان معروف أم لا
• standardizedline1، line2، city، state، zip، country
• latitude · longitudeإحداثيات GPS للعنوان
• deliverabilityresidential، commercial…
• confidenceمؤشر ثقة من 0 إلى 1
• degradedصحيح: لم يُجب المزوّد، أعد المحاولة

لماذا x402 للوكيل

لا حساب يُنشأ، ولا مفتاح يُحفظ، ولا اشتراك: يدفع الوكيل بالضبط ما يستهلكه، لحظة استهلاكه. يُرفض أي تفويض سبق استخدامه: الدفعة نفسها لا تُحتسب مرتين أبدًا.

معلومات مفيدة

• الولايات المتحدة تُتحقَّق عبر USPS (DPV)، وفرنسا وأقاليم ما وراء البحر عبر قاعدة العناوين الوطنية (BAN)؛ أما بقية الدول فالتحقق فيها جزئي.
• قيمة degraded الصحيحة تعني أن المزوّد لم يُجب: ليس عنوانًا خاطئًا، أعد الاستدعاء لاحقًا.
• لا أكثر من 10 طلبات في الثانية لكل عنوان IP.
• لا يُحفظ العنوان في السجلات؛ وتبقى النتيجة 30 يومًا في الذاكرة المؤقتة لنجيب أسرع.
• المتجر الذي لا يملك محفظة يستخدم الخدمة نفسها بمفتاح API واشتراك.

أسئلة شائعة

دليل الربط الأسعار مقارنة الأسعار