Claude Agent SDK

Generisches AI Agent Framework mit Tool Use Integration für Claude

Dieses SDK ermöglicht es, leistungsstarke AI Agents zu bauen, die selbstständig die richtigen Tools auswählen und nutzen können. Vorkonfigurierte Integrationen für Apify, Notion, Lemlist, Hunter.io, Fireflies und Perplexity.

🎯 Features

• ✅ Tool Use Integration: Claude entscheidet selbst, welche Tools es nutzt
• ✅ Agentic Workflow: Multi-Step Reasoning mit automatischer Tool-Orchestrierung
• ✅ Vorkonfigurierte Tools: Apify, Notion, Lemlist, Hunter.io, Fireflies, Perplexity
• ✅ Erweiterbar: Eigene Custom Tools in Minuten hinzufügen
• ✅ TypeScript: Vollständig typisiert
• ✅ Production-Ready: Fehlerbehandlung, Logging, Conversation History

📦 Installation

npm install
npm run build

🚀 Quick Start

1. Basic Usage

import { createAgent } from './src/sdk/index.js';

const agent = createAgent({
  anthropicApiKey: 'sk-ant-...',
  perplexityApiKey: 'pplx-...' // Optional
});

const response = await agent.run(
  'Finde aktuelle Gehälter für Software Engineers in Berlin',
  'Du bist ein hilfreicher Assistent.'
);

console.log(response);

2. Mit mehreren Tools

const agent = createAgent({
  anthropicApiKey: 'sk-ant-...',
  apifyApiToken: 'apify_api_...',
  notionApiKey: 'secret_...',
  notionKandidatenDb: 'db-id-123',
  notionKundenDb: 'db-id-456',
  lemlistApiKey: 'lemlist-key',
  hunterApiKey: 'hunter-key'
});

// Claude kann jetzt ALLE Tools nutzen!
const response = await agent.run(
  'Scrape LinkedIn Jobs für "Senior Engineer" in München, finde HR-Kontakte und speichere in Notion',
  'Du bist ein Recruiting-Assistent.'
);

🔧 Verfügbare Tools

Apify (Web Scraping)

• scrape_indeed - Scrapt Jobs von Indeed
• scrape_linkedin - Scrapt Jobs von LinkedIn

Notion (Datenbank)

• search_kandidaten - Sucht in Kandidaten-DB
• create_kandidat - Erstellt neuen Kandidaten
• search_kunden - Sucht in Kunden-DB
• create_kunde - Erstellt neuen Kunden

Lemlist (Email-Kampagnen)

• create_campaign - Erstellt Email-Kampagne
• add_leads - Fügt Leads hinzu
• get_campaign_stats - Holt Statistiken

Hunter.io (Email-Finder)

• find_email - Findet Email-Adresse einer Person
• domain_search - Findet alle Emails einer Domain
• verify_email - Verifiziert Email-Adresse

Fireflies (Meeting-Transkripte)

• get_transcripts - Holt Transkripte
• get_transcript_details - Detaillierte Infos
• search_in_transcripts - Sucht in Transkripten

Perplexity (KI-Search)

• search_web - Web-Suche mit KI
• deep_research - Tiefgehende Recherche
• analyze_company - Unternehmensanalyse
• salary_benchmark - Gehalts-Benchmarks

🎨 Custom Tools

Du kannst einfach eigene Tools hinzufügen:

import { ClaudeAgentSDK } from './src/sdk/index.js';

const agent = new ClaudeAgentSDK({
  anthropicApiKey: 'sk-ant-...'
});

// Custom Tool registrieren
agent.registerTool(
  'get_weather',
  {
    name: 'get_weather',
    description: 'Holt das aktuelle Wetter',
    input_schema: {
      type: 'object',
      properties: {
        location: { type: 'string', description: 'Stadt' }
      },
      required: ['location']
    }
  },
  async (params) => {
    // Deine Logic hier
    return { temperature: 22, condition: 'sunny' };
  }
);

💼 Use Case: TEKOM Recruiting Agent

Das Projekt enthält einen vollständigen Recruiting Agent als Beispiel:

# Agent starten
npm start run "Scrape LinkedIn Jobs für Senior C++ Engineer in München"

# Interaktiver Chat
npm start chat

Beispiel-Anfragen:

• "Scrape Indeed und LinkedIn für Defense Engineers"
• "Finde HR-Kontakte von BMW und Hensoldt"
• "Erstelle eine Outreach-Kampagne für Aerospace Engineers"
• "Analysiere Gehalts-Trends für Software Engineers in Deutschland"

📁 Projektstruktur

tekom-agent-v2/
├── src/
│   ├── sdk/                      # 🎯 CORE SDK
│   │   ├── agent.ts              # Agent mit Tool Use
│   │   ├── tools/                # Tool Definitions
│   │   │   ├── apify.ts
│   │   │   ├── notion.ts
│   │   │   ├── lemlist.ts
│   │   │   ├── hunter.ts
│   │   │   ├── fireflies.ts
│   │   │   └── perplexity.ts
│   │   └── index.ts              # SDK Export
│   │
│   ├── tekom-agent.ts            # 💼 Use Case: TEKOM Agent
│   └── index.ts                  # Legacy (deprecated)
│
├── examples/
│   ├── basic-usage.ts
│   └── custom-tools.ts
│
└── README.md

⚙️ Konfiguration

Erstelle eine .env Datei:

# REQUIRED
ANTHROPIC_API_KEY=sk-ant-xxx

# OPTIONAL (je nach Bedarf)
APIFY_API_TOKEN=apify_api_xxx
NOTION_API_KEY=secret_xxx
NOTION_KANDIDATEN_DB=db-id-123
NOTION_KUNDEN_DB=db-id-456
LEMLIST_API_KEY=lemlist-xxx
HUNTER_API_KEY=hunter-xxx
FIREFLIES_API_KEY=fireflies-xxx
PERPLEXITY_API_KEY=pplx-xxx

🔥 Wie es funktioniert

1. Tool Use Pattern

User: "Scrape LinkedIn Jobs und speichere in Notion"

Agent: 
  1. ↪ Nutzt scrape_linkedin Tool
  2. ↪ Verarbeitet Ergebnisse
  3. ↪ Nutzt create_kunde Tool (Notion)
  4. ✅ Gibt Zusammenfassung zurück

2. Multi-Step Reasoning

User: "Finde HR-Kontakte von Defense-Firmen in München"

Agent:
  1. ↪ search_web (Perplexity) → Findet Defense-Firmen
  2. ↪ domain_search (Hunter.io) → Holt HR-Emails
  3. ↪ create_kunde (Notion) → Speichert Kontakte
  4. ✅ Zusammenfassung mit Links

3. Conversation History

Der Agent behält den Kontext:

const agent = createAgent({...});

await agent.run('Scrape LinkedIn Jobs für Engineers');
// Agent scrapt Jobs

await agent.run('Speichere die Top 5 in Notion');
// Agent nutzt Ergebnisse vom vorherigen Call!

🧪 Beispiele

Web Scraping + Notion

await agent.run(
  'Scrape Indeed für "C++ Engineer" in München und speichere Top 10 Firmen in Notion',
  systemPrompt
);

Email-Kampagne erstellen

await agent.run(`
  Erstelle eine Email-Kampagne für Defense Engineers mit:
  - 3 Emails (Intro, Follow-up, Breakup)
  - Professioneller Ton
  - Fokus auf spannende Projekte
`, systemPrompt);

Markt-Recherche

await agent.run(
  'Analysiere den Markt für Aerospace Engineers: Gehälter, Trends, Top-Arbeitgeber',
  systemPrompt
);

📊 API Limits & Kosten

| Service | Free Tier | Kosten | |---------|-----------|--------| | Anthropic Claude | - | ~$3 / 1M Input Tokens | | Apify | $5 Credits/Monat | Pay-as-you-go | | Notion | ✅ Unlimited | Kostenlos | | Lemlist | - | Ab $59/Monat | | Hunter.io | 25 Searches/Monat | Ab $49/Monat | | Fireflies | 800 Min/Monat | Ab $10/Monat | | Perplexity | 5 Requests/Monat | $20/Monat (Standard) |

🛠️ Development

# Dev-Modus mit Auto-Reload
npm run dev

# TypeScript kompilieren
npm run build

# Type-Check
npm run type-check

# TEKOM Agent testen
npm start run "deine nachricht"

📚 Weitere Ressourcen

• Anthropic Tool Use Docs
• Apify API
• Notion API
• Lemlist API
• Hunter.io API
• Fireflies API
• Perplexity API

🤝 Use Cases

Dieses SDK eignet sich für:

• 🎯 Recruiting Automation (wie TEKOM Agent)
• 🔍 Market Research & Intelligence
• 📧 Sales & Outreach Automation
• 📊 Data Collection & Analysis
• 🤖 Custom AI Agents für beliebige Workflows

📝 Lizenz

MIT License - TEKOM Industrielle Systemtechnik GmbH

🚀 Next Steps

1. ✅ SDK ist fertig und einsatzbereit
2. 💡 Füge deine eigenen Tools hinzu
3. 🎨 Passe den System Prompt an
4. 🚢 Deploy als API oder CLI-Tool

Happy Agent Building! 🤖