agentsclimarketplace

Track investors on x

Skill jongall45/frontrun-skills/skills/track-investors-on-x

Agent skills for sourcing startup deals with Frontrun — pre-round signal from 1,000+ investor follow graphs on X. For Claude Code, Cursor, and any MCP-capable agent.

Install
npx -y skills add jongall45/frontrun-skills --skill track-investors-on-x

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

2 things to look at

  • 22 days oldThe repository was created 22 days ago. New is not bad, but a brand new repository carrying a familiar-sounding name is the shape a typosquat arrives in, and there has been no time for anyone else to find a problem with it.
  • 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

Track VC investors on X (Twitter) and detect who they follow with the Frontrun API: new-follow detection, investor convergence, trending companies, and per-investor activity timelines. Use when asked to monitor what VCs or investors are following on X or Twitter, track investor accounts, find companies multiple investors just followed, watch investor follow activity, or set up follow-graph signal for deal sourcing.

SKILL.md

13.1 KB, as published. Nobody here has run it

Track investors on X and read their follow signal

Every Frontrun signal endpoint is computed from the accounts you track: add investor handles, Frontrun snapshots their follow graphs, and the diffs become your deal signal. When several tracked investors independently follow the same small account, that is convergence, the strongest pre-round tell in the product.

Auth and pricing (the honest version)

Every /v1 request needs an API key in the X-API-Key header. Keys are generated at https://www.frontrun.vc under Settings > API Keys. API + MCP access is included with the Frontrun Pro plan ($99/mo, 10,000 monthly credits; pay upfront, API access unlocks immediately, no trial on Pro). The Frontrun app itself has a 7-day free trial, but the API and MCP surface sit behind the Pro paywall. Top-up credit packs never expire.

Every charged response returns cost_credits and balance_credits. A 402 means insufficient credits; a 429 means a rate limit or the daily credit cap. Several expensive endpoints never charge for empty answers (convergence, thesis search, classify, founders, funding, similar VCs return cost_credits: 0 when nothing is found).

No key yet? Two free no-auth surfaces: GET https://frontrun.vc/v1/teaser/trending (JSON, top 5 trending companies, counts only) and the public page https://frontrun.vc/trending/. Both are real live data.

Machine-readable references: https://www.frontrun.vc/llms.txt and https://www.frontrun.vc/openapi.json

How tracking works (read this first)

  1. POST /v1/track an investor handle. If the account is already in the shared coverage pool it is added free and is ready instantly; brand-new accounts cost 4 credits for the baseline fetch and show ready: false until their first snapshot completes. Not-ready accounts produce no signal yet.
  2. New-account introductions are capped per key per day by tier (pro 250); re-adding pool accounts never counts against the cap.
  3. Everything downstream (/follows/new, /convergence, /trending, /feed, /discover) reads only from YOUR tracked set. Empty results usually mean thin or not-ready coverage, so check GET /v1/track before debugging anything else.

Endpoints

POST /v1/track

Add an X account (typically an investor) to your tracked set so its new follows feed every signal endpoint (/follows/new, /follows/enriched, /convergence, /trending, /feed, /discover). Costs 4 credits when the account is new to the platform (a follow baseline is fetched); accounts already in the shared coverage pool are added free. Returns 201 with ready indicating whether a follow baseline already exists; while ready=false the account produces no signal until its first snapshot completes. Handles that fail to resolve on X return 404 and are never billed. New-account introductions are capped per key per day by tier (free 20, starter 100, pro 250, enterprise 2000); adding accounts already in the coverage pool does not count against the cap.

Body fields:

  • username (required) X username to track (with or without @).
curl -s -X POST "https://frontrun.vc/v1/track" \
  -H "X-API-Key: $FRONTRUN_API_KEY" -H "Content-Type: application/json" \
  -d '{"username":"pmarca"}'

GET /v1/track

List every account you are tracking, with readiness state (ready=false means the follow baseline is still being established, so that account is not yet producing signal). Free, costs 0 credits. Use it to verify coverage before interpreting empty results from signal endpoints.

curl -s "https://frontrun.vc/v1/track" -H "X-API-Key: $FRONTRUN_API_KEY"

DELETE /v1/track/{username}

Remove an account from your tracked set so it stops feeding your signal endpoints. Free, costs 0 credits. Returns 404 if you are not tracking the account.

Parameters:

  • username (path, required) X username to stop tracking (with or without @).
curl -s -X DELETE "https://frontrun.vc/v1/track/pmarca" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/preview/{handle}

Preview any X account before tracking it: live profile summary, computed signal-potential score (0 to 1), a tracking recommendation (strong_track, consider_tracking, or low_signal), and a sector hint. Costs 4 credits. Use it to qualify /discover candidates before adding them with POST /track. Rate limited to 20 requests/hour per key (429 beyond that), separate from credit charges.

Parameters:

  • handle (path, required) X handle to preview (with or without @).
curl -s "https://frontrun.vc/v1/preview/pmarca" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/follows/new

Detect new follows across your tracked accounts within a time window, grouped per tracked account. Costs 16 credits. Only tracked accounts with an established baseline are checked; with no ready accounts you get an empty result plus a hint message, not an error. Set classify=true to include cached AI classification on each new follow at no extra cost. Prefer /follows/enriched (same 16-credit price) when you want sector, keyword, entity-type, or tag filters and your custom rules merged in.

Parameters:

  • since (query, default "24h") Time window: relative ("24h", "7d") or absolute date ("YYYY-MM-DD"). Default "24h".
  • hours (query) Alternative to since - window size in hours (e.g. hours=48 equals since=48h).
  • username (query) Restrict to a single tracked account.
  • classify (query) Set to "true" to include cached AI classification on each new follow (no extra charge).
  • offset (query, default 0) Pagination offset (default 0).
  • limit (query, default 50) Maximum results to return (default 50, max 200).
curl -s "https://frontrun.vc/v1/follows/new?since=24h&classify=true&limit=10" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/follows/enriched

The most capable follow-signal endpoint: new follows with AI classification plus your custom classification rules and custom tags merged into each result, filterable by sector, keyword, entity type, or custom tag. Same 16-credit price as /follows/new, so use this whenever you want filtered results (e.g. sector=AI follows from the last 7d). Filters are substring matches; valid sector strings can be discovered via /sectors.

Parameters:

  • since (query, default "24h") Time window: relative ("24h", "7d") or absolute date ("YYYY-MM-DD"). Default "24h".
  • hours (query) Alternative to since - window size in hours (e.g. hours=48 equals since=48h).
  • username (query) Restrict to a single tracked account.
  • sector (query) Filter by classified sector (substring match).
  • keyword (query) Filter by keyword across username, name, description, and sector.
  • entity_type (query) Filter by entity type (substring match).
  • tag (query) Filter by your custom tag / matched rule name.
  • offset (query, default 0) Pagination offset (default 0).
  • limit (query, default 50) Maximum results to return (default 50, max 200).
curl -s "https://frontrun.vc/v1/follows/enriched?since=7d&sector=AI&limit=10" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/follows/snapshot/{username}

Returns the most recent stored full follow list for a tracked account (latest snapshot, not a live X fetch). Costs 4 credits. Useful for auditing what an investor already follows; for change detection use /follows/new instead. The username must be one of your tracked accounts.

Parameters:

  • username (path, required) Tracked account username (with or without @).
curl -s "https://frontrun.vc/v1/follows/snapshot/pmarca" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/convergence

Detect entities that multiple tracked accounts followed independently within a time window: the strongest pre-round signal in the product. Results are ranked by how many tracked accounts converged (followed_by). Costs 60 credits; zero convergences cost 0 credits. threshold (alias min_accounts) sets the minimum converging accounts, default 2; use 3+ for high conviction. Typical chain: /convergence, then /company/{handle} and /company/{handle}/founders on the top hits.

Parameters:

  • threshold (query, default 2) Minimum number of tracked accounts that must have followed the entity (alias: min_accounts). Default 2.
  • since (query, default "7d") Time window: relative ("24h", "7d") or absolute date ("YYYY-MM-DD"). Default "7d".
  • hours (query) Alternative to since - window size in hours (e.g. hours=48 equals since=48h).
  • limit (query, default 50) Maximum results to return (default 50, max 500).
curl -s "https://frontrun.vc/v1/convergence?threshold=3&since=7d&limit=10" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/trending

Entities ranked by how many of your tracked accounts followed them within the window: the standard first scan of the day. Costs 24 credits. classify=true attaches cached AI classification and adds 16 credits per classified entity returned, so keep limit small when classifying. Returns an empty hint response if you track no accounts; add coverage with POST /track first.

Parameters:

  • since (query, default "7d") Time window: relative ("24h", "7d") or absolute date ("YYYY-MM-DD"). Default "7d".
  • limit (query, default 25) Maximum results to return (default 25, max 100).
  • offset (query, default 0) Pagination offset (default 0).
  • classify (query) Set to "true" to attach cached AI classification (adds 16 credits per classified entity).
curl -s "https://frontrun.vc/v1/trending?since=7d&limit=15" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/feed

Chronological event stream across all tracked accounts, newest first: new_follow and convergence events with classification on the target, filterable by event type, sector, and time window. Costs 16 credits. Good for polling-based monitoring; for push delivery of the same events register a webhook via POST /webhooks instead.

Parameters:

  • event_type (query) Filter to a single event type.
  • since (query, default "24h") Time window: relative ("24h", "7d") or absolute date ("YYYY-MM-DD"). Default "24h".
  • hours (query) Alternative to since - window size in hours (e.g. hours=48 equals since=48h).
  • sector (query) Filter events by classified sector (substring match).
  • limit (query, default 50) Maximum results to return (default 50, max 200).
curl -s "https://frontrun.vc/v1/feed?event_type=convergence&since=24h&limit=10" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/vc/{username}/activity

Activity profile for one of your tracked accounts: follow velocity (follows per week), sector distribution of new follows in the window, and the recent follows themselves. Costs 24 credits. Returns 404 if you are not tracking the username. Use it to understand what an individual investor is looking at right now.

Parameters:

  • username (path, required) Tracked account username (with or without @).
  • since (query, default "30d") Time window: relative days ("30d") or absolute date ("YYYY-MM-DD"). Default "30d".
curl -s "https://frontrun.vc/v1/vc/pmarca/activity?since=30d" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/vc/{handle}/similar

Find accounts with follow patterns similar to a given tracked account, computed from follow-graph overlap across the coverage pool. Costs 60 credits; zero results cost 0 credits. Results include is_tracked, so this doubles as a coverage-expansion tool: preview untracked similar accounts with /preview/{handle}, then POST /track them.

Parameters:

  • handle (path, required) Tracked account handle (with or without @).
  • limit (query, default 20) Maximum results to return (default 20, max 50).
  • min_overlap (query, default 0.1) Minimum overlap score, 0 to 1 (default 0.1).
curl -s "https://frontrun.vc/v1/vc/pmarca/similar?limit=10" -H "X-API-Key: $FRONTRUN_API_KEY"

GET /v1/discover

Personalized coverage-expansion recommendations: entities followed by 2+ of your tracked accounts that you are not tracking yet, scored by signal strength (0 to 1) and matched against your custom classification rules. Costs 60 credits. Typical flow: /discover, then GET /preview/{handle} on candidates, then POST /track the good ones.

Parameters:

  • sector (query) Filter recommendations by sector (substring match).
  • min_signal (query, default 0.3) Minimum signal score, 0 to 1 (default 0.3).
  • limit (query, default 20) Maximum results to return (default 20, max 50).
curl -s "https://frontrun.vc/v1/discover?limit=10" -H "X-API-Key: $FRONTRUN_API_KEY"

Recipes

which companies gained 3+ tracked follows in the last 7 days? sector-tag and rank them.

what has @pmarca been following this month? cluster by sector.

find investors with follow patterns similar to my best-performing tracked account
and add the top 3 to tracking.

For company deep-dives on what this surfaces, use the startup-fundraising-data skill; for semantic sourcing, startup-thesis-search.

Keep looking

Skills are one crate of 328,083. Ordering is by how many stacks a row turns up in, so the top of any crate is what has actually been picked rather than what has the most stars.