Skill: froemic/specter (version 1.0.0)

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: ```bash git clone [REDACTED_SECRET]: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](https://app.tryspecter.com/settings/api-console)): - **Recommended:** Add to `~/.claude/.env` for Claude Code - **Alternative:** Add to `~/.bashrc` or `~/.zshrc`: `export SPECTER_API_KEY="your-api-key"` Repository: [REDACTED_SECRET]:FroeMic/tryspecter-cli.git ## Commands ### Company enrichment and lookup: ``` specter companies enrich --domain <domain> # Enrich company by domain specter companies enrich --linkedin <url> # Enrich company by LinkedIn URL specter companies enrich --website <url> # Enrich company by website specter companies get <companyId> # Get company details by Specter ID specter companies similar <companyId> # Find similar companies specter companies people <companyId> # Get team members specter companies search <query> # Search companies by name or domain ``` ### People enrichment and lookup: ``` specter people enrich --linkedin <url> # Enrich person by LinkedIn identifier specter people get <personId> # Get person details by Specter ID specter people email <personId> # Get person's email address specter people find-by-email <email> # Reverse lookup person by email ``` ### List management: ``` specter lists companies list # List all company lists specter lists companies create <name> # Create a company list specter lists companies get <listId> # Get list metadata specter lists companies results <listId> # Get companies in a list specter lists companies add <listId> # Add companies to a list specter lists companies remove <listId> # Remove companies from a list specter lists companies delete <listId> # Delete a company list specter lists people list # List all people lists specter lists people create <name> # Create a people list specter lists people results <listId> # Get people in a list specter lists people delete <listId> # Delete a people list ``` ### Saved searches: ``` specter searches list # List all saved searches specter searches delete <searchId> # Delete a saved search specter searches companies get <searchId> # Get company search details specter searches companies results <searchId> # Get company search results specter searches people get <searchId> # Get people search details specter searches people results <searchId> # Get people search results specter searches talent get <searchId> # Get talent search details specter searches talent results <searchId> # Get talent signal results specter searches investor-interest get <searchId> # Get investor interest details specter searches investor-interest results <searchId> # Get investor interest results ``` ### Signals: ``` specter talent get <signalId> # Get talent signal details specter investor-interest get <signalId> # Get investor interest signal ``` ### Entity extraction: ``` specter entities search --text "..." # Extract companies/investors from text specter entities search --file <path> # Extract entities from a file (max 1000 chars) ``` ### Global options: ``` --api-key <key> # Override SPECTER_API_KEY --format <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 - **Base URL:** `https://app.tryspecter.com/api/v1` - **Auth:** `X-[REDACTED_SECRET]` - **Rate Limits:** 15 requests per second per API key (auto-retry with exponential backoff) - **Credits:** Per-team allocation, 1 credit per successful result, resets monthly ### Common API Operations Enrich a company by domain: ```bash curl -X POST https://app.tryspecter.com/api/v1/companies/enrich \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"domain": "example.com"}' ``` Enrich a person by LinkedIn: ```bash curl -X POST https://app.tryspecter.com/api/v1/people/enrich \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"linkedin": "https://www.linkedin.com/in/johndoe"}' ``` Search companies: ```bash curl -X GET "https://app.tryspecter.com/api/v1/companies/search?query=acme" \ -H "X-[REDACTED_SECRET]" ``` Get company search results: ```bash curl -X GET "https://app.tryspecter.com/api/v1/searches/companies/<searchId>/results?page=0&limit=50" \ -H "X-[REDACTED_SECRET]" ``` ## Notes - Saved searches must have "Share with API" enabled on the Specter platform before they appear via the API. - API-created lists are automatically shareable; platform-created lists need "Share with API" toggled on. - Saved searches cannot be created through the API, only queried and deleted. - Company IDs use the format `comp_*`, people IDs use `per_*`. - Pagination uses 0-indexed `page` and `limit` (max 5000) query parameters. - The CLI automatically retries rate-limited requests up to 3 times with exponential backoff. - Set `DEBUG_API_ERRORS=true` for detailed error logging during troubleshooting.


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