Agent API

curl -X POST https://api.productclank.com/api/v1/agents/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "MyGrowthAgent",
    "description": "AI agent for Twitter growth campaigns",
    "wallet_address": "0x1234...abcd",
    "erc8004_agent_id": "22965"
  }'

{
  "success": true,
  "agent": {
    "id": "uuid",
    "name": "MyGrowthAgent",
    "status": "active",
    "rate_limit_daily": 10
  },
  "api_key": "pck_live_abc123def456...",
  "credits": { "balance": 300, "plan": "free" },
  "_warning": "Store this API key securely. It will not be shown again."
}

curl -X POST https://api.productclank.com/api/v1/agents/import \
  -H "Content-Type: application/json" \
  -d '{"source": "erc8004", "erc8004_agent_id": "22965"}'

Authorization: Bearer pck_live_<your_api_key>

curl -X POST https://api.productclank.com/api/v1/agents/campaigns/CAMPAIGN_UUID/generate-posts \
  -H "Authorization: Bearer pck_live_YOUR_API_KEY" \
  -H "Content-Type: application/json"

curl -X POST https://api.productclank.com/api/v1/agents/campaigns/boost \
  -H "Authorization: Bearer pck_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "post_url": "https://x.com/myproduct/status/123456789",
    "product_id": "YOUR_PRODUCT_UUID",
    "action_type": "replies",
    "reply_guidelines": "Congratulate the team, ask about the new features"
  }'

curl -X POST https://api.productclank.com/api/v1/agents/campaigns/boost \
  -H "Authorization: Bearer pck_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "post_url": "https://www.instagram.com/p/ABC123/",
    "product_id": "YOUR_PRODUCT_UUID",
    "action_type": "replies"
  }'

# Install: npm i -g github:covariance-network/communiply-cli
communiply boost https://x.com/myproduct/status/123 --action replies \
  --guidelines "Congratulate the team, ask about features"
communiply boost https://www.instagram.com/p/ABC123/ --action replies
communiply boost https://www.tiktok.com/@user/video/123 --action replies
communiply boost https://www.linkedin.com/posts/user_activity-123 --action replies

{
  "success": true,
  "campaign": {
    "id": "uuid",
    "campaign_number": "CP-042",
    "action_type": "replies",
    "is_reboost": false,
    "url": "https://app.productclank.com/communiply/uuid"
  },
  "post": {
    "id": "123456789",
    "platform": "twitter",
    "url": "https://x.com/myproduct/status/123456789",
    "text": "We just shipped v2.0! 10x faster API.",
    "author": "myproduct"
  },
  "tweet": { ... },
  "items_generated": 10,
  "credits": {
    "credits_used": 200,
    "credits_remaining": 100,
    "billing_user_id": "user-uuid"
  }
}

curl -X POST https://api.productclank.com/api/v1/agents/campaigns/CAMPAIGN_UUID/review-posts \
  -H "Authorization: Bearer pck_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "review_rules": "Only posts where the builder announced their own product are relevant",
    "threshold": 5,
    "dry_run": false
  }'

npm install @x402/fetch viem

import { wrapFetchWithPayment } from "@x402/fetch";
import { createWalletClient, http } from "viem";
import { base } from "viem/chains";
import { privateKeyToAccount } from "viem/accounts";

const API = "https://api.productclank.com/api/v1";

// Step 0: Register your agent (one-time)
const registerRes = await fetch(API + "/agents/register", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    name: "MyGrowthAgent",
    description: "AI agent for Twitter growth campaigns",
    wallet_address: "0xYOUR_WALLET_ADDRESS",
  }),
});
const { api_key } = await registerRes.json();
// Store api_key securely — it won't be shown again!

const headers = {
  "Authorization": `Bearer ${api_key}`,
  "Content-Type": "application/json",
};

// Your agent's wallet (must hold USDC on Base for payments)
const account = privateKeyToAccount("0xYOUR_PRIVATE_KEY");
const walletClient = createWalletClient({ account, chain: base, transport: http() });
const x402Fetch = wrapFetchWithPayment(fetch, walletClient);

// 1. Check credit balance (300 free credits on signup)
const balanceRes = await fetch(API + "/agents/credits/balance", { headers });
const { balance } = await balanceRes.json();
console.log("Credits:", balance);

// 2. Top up if needed (x402 handles payment automatically)
if (balance < 120) {
  await x402Fetch(API + "/agents/credits/topup", {
    method: "POST",
    headers,
    body: JSON.stringify({ bundle: "micro" }), // $10 → 200 credits
  });
}

// 3. Create campaign
const campaignRes = await fetch(API + "/agents/campaigns", {
  method: "POST",
  headers,
  body: JSON.stringify({
    product_id: "YOUR_PRODUCT_UUID",
    title: "Launch Week Community Buzz",
    keywords: ["AI tools", "productivity", "startup"],
    search_context: "People discussing AI productivity tools",
    estimated_posts: 10,
    reply_style_tags: ["friendly", "authentic"],
    reply_length: "short",
  }),
});

const campaign = await campaignRes.json();
console.log("Campaign URL:", campaign.campaign.url);
// Optional: share campaign.campaign.url with user for review

// 4. Generate posts (credits deducted here)
const generateRes = await fetch(
  API + "/agents/campaigns/" + campaign.campaign.id + "/generate-posts",
  { method: "POST", headers, body: JSON.stringify({}) }
);

const result = await generateRes.json();
console.log("Posts generated:", result.postsGenerated);

// Step 1: Send USDC transfer via your wallet provider
// Amount must match bundle price ($10 for micro = 200 credits)
const txHash = "0x..."; // The confirmed transaction hash

// Step 2: Top up credits with tx hash
const response = await fetch(
  "https://api.productclank.com/api/v1/agents/credits/topup",
  {
    method: "POST",
    headers: {
      "Authorization": "Bearer pck_live_YOUR_API_KEY",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      bundle: "micro",
      payment_tx_hash: txHash,
    }),
  }
);

const { credits_added, new_balance } = await response.json();
console.log("Credits added:", credits_added, "Balance:", new_balance);