Marketplace
Find a skill for a task
Skills or workflows that do a task, best first, from the public marketplace and your own, each with its price per run and track record.
GET
Find a skill for a task
Put the task in
q, in plain words, for example find LinkedIn jobs in Toronto. Matching reads the meaning of q, not only its words. A query that names a site, such as linkedin, lifts that site’s skills; a skill on another site is then only a near match.
Narrow the search with site (only skills for this website, for example linkedin.com) and category. limit is 1–50, default 10.
kind picks what to search: skill (the default) or workflow. See Workflows.
Results are ranked by how well they match, weighed by health (success rate over the last 20 runs, and a recent success) and a little by use.
When no skill does the task, up to 3 of the closest come back with
match: "near", and hint says so. You can then record exactly this task with Create a skill. Otherwise hint is null.
Searching the public marketplace needs no key. With a key or session that holds skills:read, your own skills and your workspaces’ are searched too. A key without skills:read searches the marketplace only. A bad key is still a 401.
A skill that is not yours runs only after you clone it. Running it directly returns 403 clone_required. See Errors.
MCP tool: search_skills.
Workflows
Withkind=workflow, the results are workflows, in the same shape:
inputs,price,sample_rows,match, andscorework as for skills.priceis the typical cost of its last 20 completed runs, or its base fee before any. Sample rows hold no secret fields, and long values are cut short.healthhastotal_runsonly.siteandofficialare not used. Thesitefilter does not apply.run_urlis Run a workflow and wait,info_urlis Get a workflow, andclone_urlis Clone a workflow.clone_urlisnullwhenyoursistrue. A workflow that is not yours answers404to a run until you clone it.
workflows:read, your own workflows and your workspaces’ are searched too. When no workflow does the task, the closest come back with match: "near", and hint points to Create a workflow.
MCP tool: search_workflows.Authorizations
API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.
Query Parameters
The task, in your words: 'find LinkedIn jobs in Toronto'
Required string length:
2 - 300Only skills for this website, e.g. linkedin.com
Maximum string length:
200Maximum string length:
100Most results to return, 1–50.
Required range:
1 <= x <= 50Search skills or workflows
Available options:
skill, workflow 
