Skip to content

quotentiroler/prospector

Repository files navigation

Prospector

AI-powered lead generation agent for GitHub repos and websites. Analyzes products, discovers potential customers, enriches contacts, and drafts personalized outreach.

Live: https://prospector-eta.vercel.app

Using Prospector as an AI Agent (x402 Protocol)

Other AI agents can purchase and use Prospector's services programmatically via the Nevermined x402 payment protocol.

Identifiers

Agent ID: 28744455506253719439355309070854035710561167109692836172020876792102066260600
Plan ID:  75487548881585806765891238817506375815024719766032068317736664462463369221318

Step 1: Purchase a plan

import { Payments } from '@nevermined-io/payments'

const payments = Payments.getInstance({
  nvmApiKey: 'your-nvm-api-key',
  environment: 'sandbox',
})

const PLAN_ID = '75487548881585806765891238817506375815024719766032068317736664462463369221318'

await payments.plans.orderPlan(PLAN_ID)

Step 2: Get an x402 access token

const AGENT_ID = '28744455506253719439355309070854035710561167109692836172020876792102066260600'

const { accessToken } = await payments.x402.getX402AccessToken(PLAN_ID, AGENT_ID)

Step 3: Call the agent

Include the token in the payment-signature header.

Quick query (1 credit):

curl -X POST https://prospector-eta.vercel.app/api/ask \
  -H "Content-Type: application/json" \
  -H "payment-signature: <accessToken>" \
  -d '{"query": "analyze https://github.com/owner/repo and suggest who would buy it"}'

Specific action (variable credits):

curl -X POST https://prospector-eta.vercel.app/api/use \
  -H "Content-Type: application/json" \
  -H "payment-signature: <accessToken>" \
  -d '{
    "action": "analyze-product",
    "repoContext": {
      "name": "my-tool",
      "full_name": "owner/my-tool",
      "description": "A developer tool",
      "language": "TypeScript",
      "stars": 100
    }
  }'

Available actions

Action Credits Description
analyze-product 2 Deep product analysis for B2B positioning
analyze-icp 2 Ideal customer profile identification
find-personas 1 Target buyer persona identification
analyze-market 3 Market landscape and competition analysis
scout-github 3 GitHub search queries to find buyers
research-web 5 Web search queries for leads
detect-signals 2 Buying signal detection (requires leads array)
enrich-contacts 3 Contact enrichment suggestions (requires leads array)
draft-outreach 2 Personalized outreach templates

Discovery

GET /api/ask returns a full self-documenting JSON spec of all endpoints, parameters, and examples. No authentication required.

Full pipeline example

// 1. Analyze the product
const analysis = await callUse('analyze-product', { repoContext })

// 2. Identify ideal customers
const icp = await callUse('analyze-icp', { repoContext })

// 3. Find leads
const scouts = await callUse('scout-github', { repoContext })
const webLeads = await callUse('research-web', { repoContext })

// 4. Detect buying signals
const signals = await callUse('detect-signals', { repoContext, leads })

// 5. Enrich contacts
const enriched = await callUse('enrich-contacts', { leads })

// 6. Draft outreach
const outreach = await callUse('draft-outreach', { repoContext, analysis: analysis.result })

Environment

Payments are optional in sandbox mode. Without a payment-signature header, requests work for free.

Variable Description
NVM_API_KEY Nevermined API key
NVM_PLAN_ID Payment plan ID
NVM_AGENT_ID Agent ID
NVM_ENVIRONMENT sandbox or production

Development

pnpm install
pnpm dev

Tech stack

  • Next.js 16 + React 19
  • Trinity AI agents (multi-agent orchestration)
  • Apify (LinkedIn/Google scraping)
  • Nevermined x402 (agent-to-agent payments)
  • Vercel (deployment)

About

find your ppl

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages