@nordsym/apiclaw 1.0.0

package/outreach/targets.md

@@ -0,0 +1,133 @@
+# APIClaw Outreach Targets
+
+> API providers att kontakta för listing i APIClaw registry
+> Senast uppdaterad: 2026-06-17
+
+## 🇸🇪 Sverige / Norden — PRIORITET 1
+
+### SMS & Communications
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **46elks** | SMS, Voice | https://46elks.com/docs | hello@46elks.com | ⬜ Pending |
+| **Sinch** | SMS, Voice, Video | https://developers.sinch.com/ | - | ⬜ Pending |
+| **Link Mobility** | SMS, RCS | https://linkmobility.com/developers | - | ⬜ Pending |
+
+### Payments & Banking
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **Klarna** | BNPL, Payments | https://docs.klarna.com/ | - | ⬜ Pending |
+| **Trustly** | Bank payments | https://developers.trustly.com/ | - | ⬜ Pending |
+| **Tink** | Open Banking | https://docs.tink.com/ | - | ⬜ Pending |
+| **Open Payments** | PSD2, Banking | https://docs.openpayments.io/ | - | ⬜ Pending |
+| **Neonomics** | Open Banking | https://developer.neonomics.io/ | - | ⬜ Pending |
+| **Nordea API Market** | Banking | https://developer.nordeaopenbanking.com/ | - | ⬜ Pending |
+| **Yapily** | Open Banking | https://docs.yapily.com/ | - | ⬜ Pending |
+
+### Identity & Verification  
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **BankID** | eID | https://www.bankid.com/utvecklare | - | ⬜ Pending |
+| **Freja eID** | eID | https://org.frejaeid.com/developers | - | ⬜ Pending |
+| **BehavioSec** | Behavioral biometrics | - | - | ⬜ Pending |
+
+---
+
+## 🌍 Internationella — PRIORITET 2
+
+### SMS & Communications
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **Twilio** | SMS, Voice, Video | https://www.twilio.com/docs | - | ⬜ Pending |
+| **Plivo** | SMS, Voice | https://www.plivo.com/docs/ | - | ⬜ Pending |
+| **Infobip** | Omnichannel | https://www.infobip.com/docs | - | ⬜ Pending |
+| **MessageBird (Bird)** | SMS, Email | https://developers.messagebird.com/ | - | ⬜ Pending |
+| **Telnyx** | SMS, Voice | https://developers.telnyx.com/ | - | ⬜ Pending |
+| **Vonage** | Communications | https://developer.vonage.com/ | - | ⬜ Pending |
+
+### Email
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **SendGrid** | Transactional email | https://docs.sendgrid.com/ | - | ⬜ Pending |
+| **Mailgun** | Transactional email | https://documentation.mailgun.com/ | - | ⬜ Pending |
+| **Postmark** | Transactional email | https://postmarkapp.com/developer | - | ⬜ Pending |
+| **Mailjet** | Email | https://dev.mailjet.com/ | - | ⬜ Pending |
+| **Resend** | Dev-first email | https://resend.com/docs | - | ⬜ Pending |
+| **Amazon SES** | Email | https://docs.aws.amazon.com/ses/ | - | ⬜ Pending |
+
+### Payments
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **Stripe** | Payments | https://stripe.com/docs/api | - | ⬜ Pending |
+| **PayPal** | Payments | https://developer.paypal.com/ | - | ⬜ Pending |
+| **Adyen** | Payments | https://docs.adyen.com/ | - | ⬜ Pending |
+| **Square** | Payments, POS | https://developer.squareup.com/ | - | ⬜ Pending |
+| **Paddle** | SaaS billing | https://developer.paddle.com/ | - | ⬜ Pending |
+| **Lemon Squeezy** | SaaS billing | https://docs.lemonsqueezy.com/ | - | ⬜ Pending |
+
+### Search
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **Algolia** | Search-as-a-service | https://www.algolia.com/doc/ | - | ⬜ Pending |
+| **Meilisearch** | Open-source search | https://www.meilisearch.com/docs | - | ⬜ Pending |
+| **Typesense** | Search | https://typesense.org/docs/ | - | ⬜ Pending |
+| **Elasticsearch** | Search/Analytics | https://www.elastic.co/guide/ | - | ⬜ Pending |
+
+### AI & Machine Learning
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **OpenAI** | LLM | https://platform.openai.com/docs | - | ⬜ Pending |
+| **Anthropic** | LLM | https://docs.anthropic.com/ | - | ⬜ Pending |
+| **Cohere** | NLP/Embeddings | https://docs.cohere.com/ | - | ⬜ Pending |
+| **Replicate** | ML models | https://replicate.com/docs | - | ⬜ Pending |
+| **Hugging Face** | ML models | https://huggingface.co/docs | - | ⬜ Pending |
+
+### Storage & CDN
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **Cloudflare** | CDN, Workers | https://developers.cloudflare.com/ | - | ⬜ Pending |
+| **Cloudinary** | Media management | https://cloudinary.com/documentation | - | ⬜ Pending |
+| **Imgix** | Image CDN | https://docs.imgix.com/ | - | ⬜ Pending |
+| **Uploadcare** | File uploads | https://uploadcare.com/docs/ | - | ⬜ Pending |
+
+### Analytics & Data
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **Mixpanel** | Product analytics | https://developer.mixpanel.com/ | - | ⬜ Pending |
+| **Amplitude** | Product analytics | https://www.docs.developers.amplitude.com/ | - | ⬜ Pending |
+| **Segment** | CDP | https://segment.com/docs/ | - | ⬜ Pending |
+| **PostHog** | Open-source analytics | https://posthog.com/docs | - | ⬜ Pending |
+
+### Auth & Identity
+| Företag | Kategori | API Docs | Kontakt | Status |
+|---------|----------|----------|---------|--------|
+| **Auth0** | Identity | https://auth0.com/docs | - | ⬜ Pending |
+| **Clerk** | Auth for devs | https://clerk.com/docs | - | ⬜ Pending |
+| **Stytch** | Passwordless auth | https://stytch.com/docs | - | ⬜ Pending |
+| **WorkOS** | Enterprise SSO | https://workos.com/docs | - | ⬜ Pending |
+
+---
+
+## 📊 Status Legend
+- ⬜ Pending — Inte kontaktad
+- 📧 Sent — Email skickat
+- 👀 Viewed — Öppnat/läst
+- 💬 Replied — Svar mottaget
+- ✅ Listed — Listad i APIClaw
+- ❌ Declined — Avböjt
+
+---
+
+## 📝 Notes
+
+### Prioritering
+1. **Svenska/Nordiska först** — närmare relation, enklare pitch
+2. **Dev-fokuserade APIs** — förstår värdet av discoverability
+3. **Mindre/nyare APIs** — hungrigare på exposure
+
+### Kontakt-strategi
+- Hitta developer relations / partnerships email
+- Alternativt: support@ eller info@
+- LinkedIn outreach som backup
+
+### Tracking
+Uppdatera status här ELLER synka till Airtable (TBD).

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@nordsym/apiclaw",
+  "version": "1.0.0",
+  "description": "The API layer for autonomous agents. MCP-native API discovery.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "apiclaw": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc && cp -r src/registry dist/",
+    "dev": "tsx watch src/index.ts",
+    "start": "node dist/index.js",
+    "test": "tsx src/test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": ["mcp", "api", "agent", "discovery", "marketplace", "claude", "openai", "autonomous", "apiclaw"],
+  "author": "NordSym <gustav@nordsym.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nordsym/apiclaw"
+  },
+  "homepage": "https://apiclaw.nordsym.com",
+  "bugs": {
+    "url": "https://github.com/nordsym/apiclaw/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.0"
+  }
+}

package/src/credits.ts

@@ -0,0 +1,261 @@
+// Credit system for APIvault
+// MVP: In-memory store. Production: Supabase
+
+import { AgentCredits, Purchase, APICredentials, UsageRecord, TransactionFee } from './types.js';
+import { randomUUID } from 'crypto';
+import { getFeePercentage, hasProSubscription } from './revenuecat.js';
+
+// In-memory stores (replace with Supabase in production)
+const agentCredits: Map<string, AgentCredits> = new Map();
+const purchases: Map<string, Purchase> = new Map();
+const usage: Map<string, UsageRecord> = new Map();
+
+// Mock API keys for demo (in production, these would be provisioned from providers)
+const mockCredentials: Record<string, () => APICredentials> = {
+  '46elks': () => ({
+    type: 'basic',
+    username: `u_${randomUUID().slice(0, 8)}`,
+    password: `p_${randomUUID().slice(0, 16)}`
+  }),
+  'resend': () => ({
+    type: 'api_key',
+    api_key: `re_${randomUUID().replace(/-/g, '')}`
+  }),
+  'brave_search': () => ({
+    type: 'api_key',
+    api_key: `BSA${randomUUID().replace(/-/g, '').toUpperCase().slice(0, 20)}`
+  }),
+  'openrouter': () => ({
+    type: 'bearer',
+    api_key: `sk-or-v1-${randomUUID().replace(/-/g, '')}`
+  }),
+  'elevenlabs': () => ({
+    type: 'api_key',
+    api_key: `${randomUUID().replace(/-/g, '')}`
+  })
+};
+
+/**
+ * Get or create agent credits account
+ */
+export function getAgentCredits(agentId: string): AgentCredits {
+  if (!agentCredits.has(agentId)) {
+    agentCredits.set(agentId, {
+      agent_id: agentId,
+      balance_usd: 0,
+      currency: 'USD',
+      created_at: new Date().toISOString(),
+      updated_at: new Date().toISOString()
+    });
+  }
+  return agentCredits.get(agentId)!;
+}
+
+/**
+ * Add credits to an agent's account
+ */
+export function addCredits(agentId: string, amountUsd: number): AgentCredits {
+  const credits = getAgentCredits(agentId);
+  credits.balance_usd += amountUsd;
+  credits.updated_at = new Date().toISOString();
+  return credits;
+}
+
+/**
+ * Purchase API access
+ * Returns credentials if successful
+ */
+export function purchaseAPIAccess(
+  agentId: string,
+  providerId: string,
+  amountUsd: number
+): { success: boolean; purchase?: Purchase; error?: string } {
+  const credits = getAgentCredits(agentId);
+  
+  // Check balance
+  if (credits.balance_usd < amountUsd) {
+    return {
+      success: false,
+      error: `Insufficient balance. Have $${credits.balance_usd.toFixed(2)}, need $${amountUsd.toFixed(2)}`
+    };
+  }
+  
+  // Check if provider exists
+  if (!mockCredentials[providerId]) {
+    return {
+      success: false,
+      error: `Unknown provider: ${providerId}`
+    };
+  }
+  
+  // Deduct credits
+  credits.balance_usd -= amountUsd;
+  credits.updated_at = new Date().toISOString();
+  
+  // Create purchase record
+  const purchaseId = `pur_${randomUUID().slice(0, 12)}`;
+  const purchase: Purchase = {
+    id: purchaseId,
+    agent_id: agentId,
+    provider_id: providerId,
+    amount_usd: amountUsd,
+    credits_purchased: calculateCredits(providerId, amountUsd),
+    status: 'active',
+    credentials: mockCredentials[providerId](),
+    created_at: new Date().toISOString()
+  };
+  
+  purchases.set(purchaseId, purchase);
+  
+  // Initialize usage tracking
+  usage.set(purchaseId, {
+    purchase_id: purchaseId,
+    provider_id: providerId,
+    units_used: 0,
+    units_remaining: purchase.credits_purchased,
+    cost_incurred_usd: 0,
+    last_used_at: new Date().toISOString()
+  });
+  
+  return { success: true, purchase };
+}
+
+/**
+ * Calculate credits based on provider pricing
+ */
+function calculateCredits(providerId: string, amountUsd: number): number {
+  // Simplified credit calculation per provider
+  const creditsPerDollar: Record<string, number> = {
+    '46elks': 30,      // ~30 SMS per dollar
+    'resend': 1000,    // ~1000 emails per dollar
+    'brave_search': 200, // ~200 searches per dollar
+    'openrouter': 100,   // ~100k tokens per dollar (varies by model)
+    'elevenlabs': 3333   // ~3333 characters per dollar
+  };
+  
+  return Math.floor(amountUsd * (creditsPerDollar[providerId] || 100));
+}
+
+/**
+ * Get all purchases for an agent
+ */
+export function getAgentPurchases(agentId: string): Purchase[] {
+  return Array.from(purchases.values()).filter(p => p.agent_id === agentId);
+}
+
+/**
+ * Get usage for a purchase
+ */
+export function getUsage(purchaseId: string): UsageRecord | null {
+  return usage.get(purchaseId) || null;
+}
+
+/**
+ * Record usage (call this when API is used)
+ */
+export function recordUsage(purchaseId: string, unitsUsed: number, costUsd: number): UsageRecord | null {
+  const record = usage.get(purchaseId);
+  if (!record) return null;
+  
+  record.units_used += unitsUsed;
+  record.units_remaining = Math.max(0, record.units_remaining - unitsUsed);
+  record.cost_incurred_usd += costUsd;
+  record.last_used_at = new Date().toISOString();
+  
+  // Update purchase status if depleted
+  if (record.units_remaining === 0) {
+    const purchase = purchases.get(purchaseId);
+    if (purchase) purchase.status = 'exhausted';
+  }
+  
+  return record;
+}
+
+/**
+ * Get full balance summary for an agent
+ */
+export function getBalanceSummary(agentId: string): {
+  credits: AgentCredits;
+  active_purchases: Purchase[];
+  total_spent_usd: number;
+} {
+  const credits = getAgentCredits(agentId);
+  const agentPurchases = getAgentPurchases(agentId);
+  const activePurchases = agentPurchases.filter(p => p.status === 'active');
+  const totalSpent = agentPurchases.reduce((sum, p) => sum + p.amount_usd, 0);
+  
+  return {
+    credits,
+    active_purchases: activePurchases,
+    total_spent_usd: totalSpent
+  };
+}
+
+/**
+ * Calculate transaction fee based on user's subscription
+ * Pro users: 2% fee
+ * Free users: 5% fee
+ */
+export async function calculateTransactionFee(
+  userId: string,
+  amountUsd: number
+): Promise<TransactionFee> {
+  const isPro = await hasProSubscription(userId);
+  const feePercentage = isPro ? 0.02 : 0.05;
+  const feeAmount = Math.round(amountUsd * feePercentage * 100) / 100;
+  
+  return {
+    amount_usd: amountUsd,
+    fee_percentage: feePercentage,
+    fee_amount_usd: feeAmount,
+    net_amount_usd: Math.round((amountUsd - feeAmount) * 100) / 100,
+    tier: isPro ? 'pro' : 'free',
+  };
+}
+
+/**
+ * Purchase API access with subscription-aware fees
+ */
+export async function purchaseAPIAccessWithFees(
+  agentId: string,
+  userId: string,
+  providerId: string,
+  amountUsd: number
+): Promise<{ 
+  success: boolean; 
+  purchase?: Purchase; 
+  fee?: TransactionFee;
+  error?: string 
+}> {
+  // Calculate fees first
+  const fee = await calculateTransactionFee(userId, amountUsd);
+  
+  // Total amount user pays = API cost + platform fee
+  const totalCost = amountUsd + fee.fee_amount_usd;
+  
+  const credits = getAgentCredits(agentId);
+  
+  if (credits.balance_usd < totalCost) {
+    return {
+      success: false,
+      error: `Insufficient balance. Have $${credits.balance_usd.toFixed(2)}, need $${totalCost.toFixed(2)} (includes ${fee.tier === 'pro' ? '2%' : '5%'} platform fee)`
+    };
+  }
+  
+  // Make the purchase (deducts API cost)
+  const result = purchaseAPIAccess(agentId, providerId, amountUsd);
+  
+  if (result.success && result.purchase) {
+    // Deduct platform fee separately
+    credits.balance_usd -= fee.fee_amount_usd;
+    credits.updated_at = new Date().toISOString();
+    
+    return {
+      success: true,
+      purchase: result.purchase,
+      fee,
+    };
+  }
+  
+  return result;
+}

package/src/discovery.ts

@@ -0,0 +1,147 @@
+// Discovery engine for APIvault
+// MVP: Keyword matching. Future: Embeddings + semantic search
+
+import { SimpleAPI } from './types.js';
+import { readFileSync } from 'fs';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Load APIs from registry
+const apisData = JSON.parse(
+  readFileSync(join(__dirname, 'registry', 'apis.json'), 'utf-8')
+);
+const apis: SimpleAPI[] = apisData.apis;
+
+console.error(`[APIvault] Loaded ${apis.length} APIs from registry`);
+
+export interface SimpleSearchResult {
+  api: SimpleAPI;
+  relevance_score: number;
+  match_reasons: string[];
+}
+
+/**
+ * Discover APIs based on a natural language query
+ * MVP uses keyword matching; production would use embeddings
+ */
+export function discoverAPIs(
+  query: string,
+  options: {
+    category?: string;
+    maxResults?: number;
+    auth?: string;
+    httpsOnly?: boolean;
+  } = {}
+): SimpleSearchResult[] {
+  const { category, maxResults = 10, auth, httpsOnly } = options;
+  
+  const queryLower = query.toLowerCase();
+  const queryWords = queryLower.split(/\s+/).filter(w => w.length > 2);
+  
+  const results: SimpleSearchResult[] = [];
+  
+  for (const api of apis) {
+    // Category filter (case-insensitive)
+    if (category && api.category.toLowerCase() !== category.toLowerCase()) continue;
+    
+    // Auth filter
+    if (auth && api.auth.toLowerCase() !== auth.toLowerCase()) continue;
+    
+    // HTTPS filter
+    if (httpsOnly && !api.https) continue;
+    
+    // Calculate relevance score
+    let score = 0;
+    const matchReasons: string[] = [];
+    
+    for (const word of queryWords) {
+      // Name match (highest weight)
+      if (api.name.toLowerCase().includes(word)) {
+        score += 25;
+        matchReasons.push(`name: ${word}`);
+      }
+      
+      // Keyword match
+      if (api.keywords && api.keywords.some(k => k.toLowerCase().includes(word))) {
+        score += 15;
+        matchReasons.push(`keyword: ${word}`);
+      }
+      
+      // Description match
+      if (api.description.toLowerCase().includes(word)) {
+        score += 10;
+        matchReasons.push(`description: ${word}`);
+      }
+      
+      // Category match
+      if (api.category.toLowerCase().includes(word)) {
+        score += 8;
+        matchReasons.push(`category: ${word}`);
+      }
+    }
+    
+    // Only add secondary boosts if there's a primary match
+    if (score > 0) {
+      // Boost for HTTPS
+      if (api.https) {
+        score += 2;
+      }
+      
+      // Boost for known CORS support
+      if (api.cors === 'yes') {
+        score += 1;
+      }
+    }
+    
+    if (score > 0) {
+      results.push({
+        api,
+        relevance_score: Math.round(score * 100) / 100,
+        match_reasons: [...new Set(matchReasons)]
+      });
+    }
+  }
+  
+  // Sort by relevance
+  results.sort((a, b) => b.relevance_score - a.relevance_score);
+  
+  return results.slice(0, maxResults);
+}
+
+/**
+ * Get detailed information about a specific API
+ */
+export function getAPIDetails(apiId: string): SimpleAPI | null {
+  return apis.find(api => api.id === apiId) || null;
+}
+
+/**
+ * List all APIs in a category
+ */
+export function listByCategory(category: string): SimpleAPI[] {
+  return apis.filter(api => api.category.toLowerCase() === category.toLowerCase());
+}
+
+/**
+ * Get all available categories
+ */
+export function getCategories(): string[] {
+  return [...new Set(apis.map(api => api.category))].sort();
+}
+
+/**
+ * Get all APIs
+ */
+export function getAllAPIs(): SimpleAPI[] {
+  return apis;
+}
+
+/**
+ * Get API count
+ */
+export function getAPICount(): number {
+  return apis.length;
+}