noticed-search

noticed Search Skill

You have access to the noticed CLI for searching developer networks.

Available Commands

Search Network

noticed search "<query>" [options]

Options:

• -l, --limit <n> — Maximum results (default 25, max 50)
• -o, --offset <n> — Pagination offset
• -s, --source <github|linkedin> — Filter by source
• --sort <col:dir> — Sort by name:asc, company:desc, etc.
• -p, --paths — Lazily fetch the shortest connection path to the top 5 hits
• -j, --json — Output JSON for further processing
• --no-color — Disable colors

Examples:

# Search by name
noticed search "Sarah Chen"

# Search by skill/topic
noticed search "AI engineers" --limit 10

# Search by company
noticed search "engineers at Google" --source github

# Get JSON output for processing (includes paths to top 5 hits)
noticed search "react developers" --json --paths

# Paginate results
noticed search "frontend" --offset 25 --limit 25

Find a Path

noticed path @sarahml             # by GitHub login
noticed path 12345                # by github_user_id
noticed path --li sarah-chen      # by LinkedIn username
noticed path @sarahml --json      # machine-readable

Use this when you already know who you want to reach. The CLI resolves a login by searching first, then calls the dedicated /api/search/path endpoint.

Configuration

# Mint an API key in the dashboard at /dashboard/api-keys, then:
noticed config --set-url https://your-instance.noticed.so
noticed config --set-key nk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Show current config
noticed config --show

MCP Server (for AI agent integration)

# Start MCP server over stdio
noticed mcp

Environment Variables

The CLI reads credentials from:

1. CLI flags (--api-url, --api-key)
2. Environment variables (NOTICED_API_URL, NOTICED_API_KEY)
3. Config file (~/.config/noticed/config.json)

Search Tips

• Natural language: "AI engineers at startups", "frontend developers who know React"
• Names: "Sarah Chen", "John Smith" — searches both GitHub and LinkedIn
• Usernames: "@sarahml" — direct GitHub login lookup
• Companies: "Google", "Vercel" — matches company fields
• Skills/Topics: "kubernetes", "machine learning" — matches skills and repo topics
• Combined: Queries with 3+ words automatically validate extra words against company/headline

Connection Paths

When --paths is used, the CLI shows the shortest path from you to each person:

You ──collab──▸ Alice ──LinkedIn──▸ Bob ──collab──▸ Target (3 hops)

This helps understand how you're connected to someone outside your direct network.