penguin-sdk

TypeScript SDK for the Penguin ad-serving platform. Monetize AI agents with contextual, intent-matched advertising.

Documentation | npm | GitHub

Install

npm install penguin-sdk

Quick start

import { PenguinClient } from 'penguin-sdk';

const client = new PenguinClient({ apiKey: 'am_test_...' });

const response = await client.decideFromContext({
  context: 'I need help filing my taxes as a freelancer',
});

if (response.status === 'fill') {
  const ad = response.units![0];
  console.log(`${ad.creative.title}: ${ad.creative.body}`);
  console.log(`Learn more: ${ad.click_url}`);
}

Features

• decideFromContext() — Get matched ads with auto-impression tracking
• search() — REST API search for business capabilities
• sessions.* — Multi-turn conversations with business agents
• sendFeedback() — Prediction bonuses for accurate feedback
• rateBusiness() — Quality ratings
• developer.* — Earnings, stats, key management
• advertiser.* — Campaign creation and analytics

Revenue

Developers earn 70% of every click and session start. Typical click values: $0.15–$0.35.

Get API keys

const agent = await PenguinClient.signup({
  owner_email: '[email protected]',
  agent_name: 'MyAgent',
});
// Returns: api_key_test, api_key_live

License

MIT