Skill: tzannetosgiannis/find-people (version 1.0.0)

--- name: find-people description: Open Source Intelligence (OSINT) tool for researching individuals - professional backgrounds, career timelines, due diligence, competitive intelligence, and investor research. Use when users need to research people, verify credentials, or gather professional information. Costs $0.15 USDC per request via x402 protocol on Base network. --- # Find People (OSINT) Research individuals using Open Source Intelligence gathering and AI-powered analysis. ## Configuration The private key must be available via one of these methods: **Option 1: Environment variable** ```bash export X402_PRIVATE_KEY="0x..." ``` **Option 2: Config file (Recommended)** The script checks for `x402-config.json` in these locations (in order): 1. Current directory: `./x402-config.json` 2. Home directory: `~/.x402-config.json` ← **Recommended** 3. Working directory: `$PWD/x402-config.json` Create the config file: ```json { "private_key": "0x1234567890abcdef..." } ``` **Example (home directory - works for any user):** ```bash echo '{"private_key": "0x..."}' > ~/.x402-config.json ``` ## Usage Run the research script with a person's name or description: ```bash scripts/research.sh "<person query>" ``` The script: - Executes OSINT research with payment handling - Costs $0.15 USDC per request (Base network) - Returns comprehensive AI-processed intelligence report ## Examples **User:** "Find information about the founder of Ethereum" ```bash scripts/research.sh "Vitalik Buterin Ethereum founder" ``` **User:** "Research the CEO of OpenAI" ```bash scripts/research.sh "Sam Altman OpenAI CEO" ``` **User:** "Tell me about Elon Musk's career timeline" ```bash scripts/research.sh "Elon Musk career history" ``` ## Capabilities - Professional background research - Career timeline verification - Due diligence on potential hires/partners - Competitive intelligence on industry leaders - Investor research on startup founders - Educational background verification - Public accomplishments and publications ## Error Handling - **"Payment failed: Not enough USDC"** → Inform user to top up Base wallet with USDC - **"X402 private key missing"** → Guide user to configure private key (see Configuration above) - **Timeout errors** → The API has a 5-minute timeout; comprehensive research may take time ## Use Cases - **Hiring:** Verify candidate backgrounds and experience - **Partnerships:** Due diligence on potential business partners - **Investment:** Research startup founders and leadership teams - **Competitive Analysis:** Track industry leaders and their moves - **Journalism:** Background research for interviews or articles

path: scripts/research.sh
content: #!/bin/bash
# OSINT research via x402 protocol
# Usage: research.sh "<person query>"

set -e

QUERY="$*"

# Check if query is provided
if [ -z "$QUERY" ]; then
    echo "Error: No research query provided"
    echo "Usage: research.sh \"<person query>\""
    exit 1
fi

# Try to find config file in multiple locations
CONFIG_LOCATIONS=(
    "./x402-config.json"
    "$HOME/.x402-config.json"
    "$PWD/x402-config.json"
)

# Check each location for config file
for CONFIG_FILE in "${CONFIG_LOCATIONS[@]}"; do
    if [ -f "$CONFIG_FILE" ]; then
        PRIVATE_KEY=$(jq -r '.private_key' "$CONFIG_FILE" 2>/dev/null || echo "")
        if [ -n "$PRIVATE_KEY" ]; then
            export X402_PRIVATE_KEY="$PRIVATE_KEY"
            break
        fi
    fi
done

# Check if private key is available
if [ -z "$X402_PRIVATE_KEY" ]; then
    echo "Error: X402 private key missing"
    echo ""
    echo "Please configure your private key using one of these methods:"
    echo "1. Set environment variable: export X402_PRIVATE_KEY=\"0x...\""
    echo "2. Create x402-config.json in current directory with:"
    echo '   {"private_key": "0x..."}'
    echo "3. Create ~/.x402-config.json in your home directory"
    exit 1
fi

# Execute the research
npx -y @itzannetos/x402-tools-claude find-people "$QUERY"


Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: clean | SkillSpector: suspicious (MEDIUM)