SafeBrowz Detection API

ملف مهارة جاهز للإضافة

هل تبني وكيل Claude أو ChatGPT Custom GPT أو قاعدة Cursor أو أي تطبيق يعتمد على نماذج اللغة؟ الصق ملف المهارة في قواعد وكيلك وسيعرف متى وكيف يستدعي الواجهة البرمجية.

ملف بيانات الإضافة في /.well-known/ai-plugin.json

سعر واحد. بدون طبقات.

شغّل تدفق x402 الكامل في متصفحك

ربط أي محفظة، الصق رابطًا، انقر اختبار. ادفع 0.001 USDC على Solana أو Base، أو 0.00001 SOL كبديل Solana أصلي. يعمل مع أي محفظة SPL أو EVM.

اختر سلسلة أدناه — يبقى السعر ثابتًا.

تحتاج إلى بعض SOL على Solana، أو USDC + ETH للغاز على Base. لا استرداد — الدفع على السلسلة.

أو جرّبه بـ curl في 30 ثانية

كل طلب يستلزم دفعة x402. الاستدعاء الأول يعيد 402 مع تعليمات الدفع. ادفع، ثم أعد المحاولة مع توقيع المعاملة.

الخطوة 1 — احصل على nonce من 402

curl -s -X POST https://api.safebrowz.com/v1/detect \
  -H "Content-Type: application/json" \
  -d '{"url":"https://app.trezor-io.us.com/"}'

الاستجابة (402)

اختر أي خيار داخل payment أو payment.alternatives. المدخل الأساسي هو Solana USDC؛ البدائل تشمل Solana SOL وBase USDC.

{
  "status": 402,
  "error": "payment_required",
  "payment": {
    "amount": "0.001",
    "token": "USDC",
    "token_mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "chain": "solana",
    "recipient": "FLQyppmJYbvQvEPAB4Mv8ZGmxkSXmXUwMACeJ79kdozW",
    "nonce": "ed548e77-719f-4f13-9f01-32dc8ed4e213",
    "memo_format": "safebrowz:ed548e77-719f-4f13-9f01-32dc8ed4e213",
    "alternatives": [
      { "token": "SOL",  "amount": "0.00001", "chain": "solana", "nonce_binding": "memo",   "memo_format": "safebrowz:..." },
      { "token": "USDC", "amount": "0.001",   "chain": "base",   "chain_id": 8453,
        "token_contract": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "recipient": "0xf3bc3a04646F1D721992AeDC07c98FC52FdFC358",
        "nonce_binding": "eip191",
        "sign_message": "safebrowz:ed548e77-719f-4f13-9f01-32dc8ed4e213" }
    ]
  }
}

الخطوة 2أ — ادفع على Solana

حوّل 0.001 USDC (أو 0.00001 SOL) للمستلم مع مذكرة safebrowz:<nonce>. أي محفظة Solana أو واجهة spl-token تعمل. تنتهي صلاحية nonces في 10 دقائق.

spl-token transfer EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v 0.001 \
  FLQyppmJYbvQvEPAB4Mv8ZGmxkSXmXUwMACeJ79kdozW \
  --fund-recipient \
  --with-memo "safebrowz:ed548e77-719f-4f13-9f01-32dc8ed4e213"

الخطوة 2ب — ادفع على Base (محافظ EVM)

أرسل تحويل USDC ERC-20 قياسي على Base إلى المستلم، ثم وقّع رسالة nonce خارج السلسلة. تفتقر Base إلى حقل مذكرة أصلي، لذا يستخدم ربط nonce توقيع EIP-191 personal_sign لـ safebrowz:<nonce>. يجب أن يرتد التوقيع إلى المحفظة التي دفعت.

// viem / ethers pseudocode
const txHash = await wallet.writeContract({
  address: "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", // USDC on Base
  abi: erc20Abi, functionName: "transfer",
  args: [ "0xf3bc3a04646F1D721992AeDC07c98FC52FdFC358", 1000n ], // 0.001 USDC (6 dec)
});
const walletSig = await wallet.signMessage({
  message: "safebrowz:ed548e77-719f-4f13-9f01-32dc8ed4e213",
});

الخطوة 3 — أعد المحاولة مع الإثبات

لـ Solana، أرسل توقيع المعاملة فقط. لـ Base، أرسل أيضًا توقيع المحفظة EIP-191 وعيّن X-402-Chain: base.

# Solana
curl -s -X POST https://api.safebrowz.com/v1/detect \
  -H "Content-Type: application/json" \
  -H "X-402-Signature: <your_tx_signature>" \
  -H "X-402-Nonce: ed548e77-719f-4f13-9f01-32dc8ed4e213" \
  -d '{"url":"https://app.trezor-io.us.com/"}'

# Base
curl -s -X POST https://api.safebrowz.com/v1/detect \
  -H "Content-Type: application/json" \
  -H "X-402-Chain: base" \
  -H "X-402-Signature: <tx_hash>" \
  -H "X-402-Wallet-Sig: <eip191_signature>" \
  -H "X-402-Nonce: ed548e77-719f-4f13-9f01-32dc8ed4e213" \
  -d '{"url":"https://app.trezor-io.us.com/"}'

الاستجابة (200)

{
  "verdict": "danger",
  "trust_score": 5,
  "brand": "Ledger",
  "confidence": 0.95,
  "reason": "Fake Ledger Live login page - potential phishing and crypto scam",
  "threat_types": ["brand_impersonation", "crypto_scam", "credential_phishing"],
  "signals": {
    "brand_impersonation": true,
    "credential_phishing": true,
    "crypto_scam": true,
    "no_contact_info": true,
    "domain_mismatch": true,
    "wallet_drainer": false,
    "seed_phrase_phishing": false,
    "fake_captcha": false,
    "pastejacking": false,
    "tech_support_scam": false
    // ...remaining signals (all booleans) omitted for brevity
  },
  "details": {
    "matched_brand": "Ledger",
    "official_domain": "ledger.com",
    "domain_matches_brand": false,
    "target_country": "Global",
    "page_language": "English"
  }
}

trust_score هو درجة ثقة بسيطة من 0 إلى 100 (100 = آمن، 0 = احتيال). confidence هو مدى يقيننا من الحكم نفسه — بالنسبة لحكم danger، 0.95 تعني "نحن متأكدون 95% بأن هذا احتيال"، وليس "مزيف بنسبة 95%."

عملاء برمجيون كاملون

انسخ أحدها، أضف محفظة، وانتهيت. كل مثال يتولى تدفق x402 كاملًا من البداية للنهاية: الاستدعاء الأولي، تحليل تحدي 402، الدفع على السلسلة، إعادة المحاولة مع رأس X-PAYMENT. يمكن خلط اللغات — الـ API متطابق بغض النظر عن العميل.

TypeScript + viem (Base)

عميل بـ ~45 سطرًا يغطي الرحلة الكاملة على Base mainnet. يستخدم viem لتحويل USDC + توقيع EIP-191 nonce.

import { createWalletClient, http, parseUnits, erc20Abi } from "viem";
import { base } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";

const USDC_BASE = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
const URL = "https://api.safebrowz.com/v1/detect";
const account = privateKeyToAccount(process.env.PRIVATE_KEY as `0x${string}`);
const wallet  = createWalletClient({ account, chain: base, transport: http() });

export async function detect(target: string) {
  // 1. First call — expect 402
  const first = await fetch(URL, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ url: target }),
  });
  if (first.status !== 402) return first.json();
  const challenge = await first.json();
  const baseEntry = challenge.accepts.find((a: any) => a.network === "base");

  // 2. Pay USDC onchain to the configured receiver
  const txHash = await wallet.writeContract({
    address: USDC_BASE, abi: erc20Abi, functionName: "transfer",
    args: [baseEntry.payTo, parseUnits("0.001", 6)],
  });

  // 3. Sign the off-chain nonce binding (EIP-191 personal_sign)
  const walletSig = await wallet.signMessage({
    message: baseEntry.extra.sign_message_template,
  });

  // 4. Retry with the spec-compliant X-PAYMENT header
  const xPayment = Buffer.from(JSON.stringify({
    x402Version: 1, scheme: "exact", network: "base",
    payload: {
      txHash, walletSig,
      nonce: baseEntry.extra.sign_message_template.split(":")[1],
    },
  })).toString("base64");

  const verdict = await fetch(URL, {
    method: "POST",
    headers: { "Content-Type": "application/json", "X-PAYMENT": xPayment },
    body: JSON.stringify({ url: target }),
  });
  return verdict.json();
}

Python + solana-py (Solana)

نفس التدفق على Solana. يستخدم solders لبناء keypair والمعاملة وتعليمة SPL-memo لربط nonce.

import base64, json, httpx, os
from solana.rpc.api import Client
from solders.keypair import Keypair
from solders.pubkey import Pubkey

USDC_MINT = Pubkey.from_string("EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v")
rpc = Client("https://api.mainnet-beta.solana.com")
kp  = Keypair.from_base58_string(os.environ["SOLANA_SECRET"])

def detect(target: str) -> dict:
    # 1. Challenge
    r = httpx.post("https://api.safebrowz.com/v1/detect",
                   json={"url": target})
    if r.status_code != 402:
        return r.json()
    sol_entry = next(a for a in r.json()["accepts"] if a["network"] == "solana")

    # 2. Build USDC transferChecked + spl-memo binding the nonce
    memo = sol_entry["extra"]["memo_template"]   # "safebrowz:<nonce>"
    tx   = build_usdc_transfer_with_memo(
        payer=kp.pubkey(),
        receiver=Pubkey.from_string(sol_entry["payTo"]),
        amount_atomic=int(sol_entry["maxAmountRequired"]),
        memo_text=memo,
    )
    tx.sign([kp], rpc.get_latest_blockhash().value.blockhash)
    tx_sig = rpc.send_transaction(tx).value

    # 3. Retry with X-PAYMENT
    x_payment = base64.b64encode(json.dumps({
        "x402Version": 1, "scheme": "exact", "network": "solana",
        "payload": {"txSignature": str(tx_sig), "nonce": memo.split(":")[1]},
    }).encode()).decode()

    return httpx.post(
        "https://api.safebrowz.com/v1/detect",
        headers={"X-PAYMENT": x_payment},
        json={"url": target},
    ).json()

بدون إعداد — agentcash CLI

إذا كنت لا تريد بناء تدفق دفع خاص بك، فإن agentcash يتولى كامل عملية x402. يكشف 402، يوقّع ويبث الدفع، يعيد المحاولة مع الرأس المتوافق مع المواصفة، ويطبع الحكم. سطر واحد:

npx agentcash fetch https://api.safebrowz.com/v1/detect \
  --body '{"url":"https://trezor-support.com"}' \
  --network solana

يعمل على كلٍّ من --network solana و--network eip155:8453. يستخدم محفظة يديرها agentcash — أضف USDC وهو يعمل تلقائيًا.

أطر عمل الوكلاء — Claude, GPT, LangChain, MCP

يمكن لكل إطار عمل وكيل رئيسي تحميل ملف المهارة المنشور واستخدام واجهة الكشف كأداة دون أي كود تكامل يدوي:

# Claude Code / Claude Desktop
#   - Save /safebrowz-api.skill.md locally
#   - Add to your ~/.claude/skills/ directory
#   - Claude loads it automatically

# MCP server config (Claude Desktop, etc.)
#   - Point at the OpenAPI spec: https://api.safebrowz.com/v1/openapi.json
#   - MCP auto-generates a detect() tool

# LangChain
from langchain.tools import OpenAPIToolkit
from langchain.utilities.openapi import OpenAPISpec
spec = OpenAPISpec.from_url("https://api.safebrowz.com/v1/openapi.json")
toolkit = OpenAPIToolkit.from_llm_and_spec(llm, spec)

مصادقة Bearer للمؤسسات (تجاوز x402)

يمكن للمتكاملين ذوي الحجم العالي — تطبيقات المحافظ ومنصات الذكاء الاصطناعي ذات الملايين من المستخدمين — طلب مفتاح Bearer طويل الأمد. لا توقيع لكل استدعاء؛ مرّر المفتاح كرأس Authorization واحصل فورًا على استجابة 200 عادية. الفوترة شهرية عبر اشتراك USDC ثابت.

curl -X POST https://api.safebrowz.com/v1/detect \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -d '{"url":"https://example.com"}'

راسل info@safebrowz.com مع حجمك المتوقع (طلبات/دقيقة + الإجمالي الشهري) لتوفير مفتاح. الطبقة المعتادة هي 10,000 إلى 100,000 طلب في الدقيقة، بحد معدل لكل مفتاح حتى يكون معدل النقل الخاص بك معزولًا عن كل عميل مؤسسي آخر.

نقاط النهاية

{"url": "https://example.com"}

{"status": "ok", "version": "1.0.0", "chain": "solana"}

الأخطاء

أسئلة شائعة

هل أنت مستعد للتكامل؟

لا نماذج لملئها. وجّه أي محفظة Solana أو EVM إلى api.safebrowz.com/v1/detect وابدأ المسح.