Specter CLI – AI powered startup and deal sourcing

SKILL.md specter-cli Enrich, search, and manage company and people data from the Specter intelligence platform via the specter-cli. Look up companies by domain, enrich professionals via LinkedIn, manage lists, query saved searches, and track talent and investor signals.

Install

Clone and install the CLI:

git clone git@github.com:FroeMic/tryspecter-cli.git
cd tryspecter-cli
npm install
npm run build
npm link

Set SPECTER_API_KEY environment variable (get it from Specter Settings > API Console):

Repository: git@github.com:FroeMic/tryspecter-cli.git

Commands

Company enrichment and lookup:

specter companies enrich --domain             # Enrich company by domain
specter companies enrich --linkedin              # Enrich company by LinkedIn URL
specter companies enrich --website               # Enrich company by website
specter companies get                      # Get company details by Specter ID
specter companies similar                  # Find similar companies
specter companies people                   # Get team members
specter companies search                       # Search companies by name or domain

People enrichment and lookup:

specter people enrich --linkedin                 # Enrich person by LinkedIn identifier
specter people get                          # Get person details by Specter ID
specter people email                        # Get person's email address
specter people find-by-email                   # Reverse lookup person by email

List management:

specter lists companies list                          # List all company lists
specter lists companies create                  # Create a company list
specter lists companies get                   # Get list metadata
specter lists companies results               # Get companies in a list
specter lists companies add                   # Add companies to a list
specter lists companies remove                # Remove companies from a list
specter lists companies delete                # Delete a company list
specter lists people list                             # List all people lists
specter lists people create                     # Create a people list
specter lists people results                  # Get people in a list
specter lists people delete                   # Delete a people list

Saved searches:

specter searches list                                 # List all saved searches
specter searches delete                     # Delete a saved search
specter searches companies get              # Get company search details
specter searches companies results          # Get company search results
specter searches people get                 # Get people search details
specter searches people results             # Get people search results
specter searches talent get                 # Get talent search details
specter searches talent results             # Get talent signal results
specter searches investor-interest get      # Get investor interest details
specter searches investor-interest results  # Get investor interest results

Signals:

specter talent get                          # Get talent signal details
specter investor-interest get               # Get investor interest signal

Entity extraction:

specter entities search --text "..."                  # Extract companies/investors from text
specter entities search --file                  # Extract entities from a file (max 1000 chars)

Global options:

--api-key        # Override SPECTER_API_KEY
--format      # Output format: json (default), table, csv
--help                # Show help
--version             # Show version

Key Concepts

| Concept | Purpose | Example | | ------------------ | -------------------------------------- | ------------------------------------------- | | Companies | Company intelligence records | Enriched company profiles with funding, team | | People | Professional profiles | LinkedIn-enriched person data | | Lists | Curated collections of companies/people | "Target Accounts", "Hiring Pipeline" | | Saved Searches | Persisted search queries on Specter | Company or people searches from the platform | | Talent Signals | Job-move indicators | Person moved to a new company | | Investor Interest | Investment activity signals | Company attracting investor attention | | Entities | Extracted mentions from text | Company/investor names in unstructured text |

API Reference

Common API Operations

Enrich a company by domain:

curl -X POST https://app.tryspecter.com/api/v1/companies/enrich \
  -H "X-API-KEY: $SPECTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "example.com"}'

Enrich a person by LinkedIn:

curl -X POST https://app.tryspecter.com/api/v1/people/enrich \
  -H "X-API-KEY: $SPECTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin": "https://www.linkedin.com/in/johndoe"}'

Search companies:

curl -X GET "https://app.tryspecter.com/api/v1/companies/search?query=acme" \
  -H "X-API-KEY: $SPECTER_API_KEY"

Get company search results:

curl -X GET "https://app.tryspecter.com/api/v1/searches/companies//results?page=0&limit=50" \
  -H "X-API-KEY: $SPECTER_API_KEY"

Notes