SourcePost skill for AI agents

A directory where AI agents find the suppliers, services, APIs and data sources they need. Open JSON API, llms.txt and an agent skill.

SourcePost is a directory for AI agents: a place to find the suppliers, services, APIs and data sources they need to get their tasks done. The catalog starts with resale sourcing and grows with what agents look for and providers offer.

This repository contains one file that matters: SKILL.md, an Agent Skill that teaches an agent how to search SourcePost through its open API and how to tell SourcePost what it offers or could not find.

Use it

• Claude Code: copy SKILL.md to ~/.claude/skills/sourcepost/SKILL.md (for all your projects) or to .claude/skills/sourcepost/SKILL.md inside a project.
• Other agents: give your agent the file, or point it to the live version at https://sourcepost.dev/skill.md (Spanish: https://sourcepost.dev/es/skill.md).

No account or API key is needed. The API is described in https://sourcepost.dev/openapi.json and https://sourcepost.dev/docs; start with https://sourcepost.dev/llms.txt.

Links

• Website: https://sourcepost.dev
• llms.txt: https://sourcepost.dev/llms.txt
• OpenAPI: https://sourcepost.dev/openapi.json
• API docs: https://sourcepost.dev/docs
• Live skill: https://sourcepost.dev/skill.md

Privacy

SourcePost has no user accounts and sets no cookies for visitors. Request records never store IP addresses. See https://sourcepost.dev/privacy.

About this repository

SKILL.md is generated from the version that sourcepost.dev serves; the live version is always the reference. Please report problems or suggestions through the contact page or the API's POST /v1/interest.

SourcePost directory — skill for agents

Versión en español: https://sourcepost.dev/es/skill.md

Use this skill when your task needs a supplier, service, API or data source. SourcePost is a directory for AI agents; its catalog starts with Resale sourcing (Suppliers, wholesale marketplaces, price data and automation tools for agents that look for products to resell.) and grows with what agents look for and providers offer.

Base URL: https://sourcepost.dev. All responses are JSON. No account or key is needed.

1. Search

GET https://sourcepost.dev/v1/listings?q=dropshipping+suppliers

• q: free text, English or Spanish (both are searched). Every word must match.
• Filters: category (see below), offer_type (api, dataset, supplier, tool, service), verified_only=true.
• Pages: limit (1–50, default 20) and offset. total is the number of matching listings.
• Language of the texts: ?lang=en (default) or ?lang=es.

Categories of the current catalog:

• automation_tool: Automation tool
• dropshipping_supplier: Dropshipping supplier
• price_data: Price data
• print_on_demand: Print on demand
• sourcing_agent: Sourcing agent
• supplier_directory: Supplier directory
• wholesale_marketplace: Wholesale marketplace

2. Read the results

• results: the listings that match, verified ones first.
• sponsored_results: paid placements (at most 3, sponsored: true). They are never mixed into results. Tell your user when a listing is sponsored.
• For each listing: title, summary, url, url_original, contact_url, has_api, has_mcp, region.
• Links: Each listing's url carries utm_source=sourcepost.dev and utm_medium=agent-directory, so the provider can see that the visit came from SourcePost; these tags never contain data about you. url_original is the same link without tags. Give your user url; use url_original if you need the clean link.
• Price: pricing_info is price information as free text (in pricing_info_lang), with its source: price_source says where it comes from (official: the provider's own site; third_party: a third party) and price_checked_at when SourcePost last checked it. Prices change: confirm on the provider's site before deciding.
• verified: true means SourcePost checked that the listing exists and works. It is not an endorsement.
• disclaimer, when present, must be shown to your user.

3. Get one listing

GET https://sourcepost.dev/v1/listings/{id}

Use the id from the search. 404 means the listing is not public (or does not exist).

4. Tell SourcePost what you offer or what you could not find

If you (or your owner) offer something that could be useful to an agent, or you did not find what you needed, send a short message. Every search response has an invitation with the URL.

POST https://sourcepost.dev/v1/interest
Content-Type: application/json

{"kind": "missing", "text": "Wholesale suppliers of bicycle spare parts that ship to Portugal."}

• kind: offer (you offer something) or missing (you could not find it).
• text: your own message, 10 to 2000 characters, English or Spanish. No personal data. The example text above is rejected (422).
• contact_url (optional): a public page where the SourcePost team can follow up.
• Answer: 201 with "published": false. Messages are read by the SourcePost team; they are not published and do not create listings.

Limits and errors

• 60 requests per minute per client; 10 messages per hour to POST /v1/interest.
• 429: too many requests. Wait the seconds in the Retry-After header, then retry.
• 422: invalid parameter or body. The response explains which one (unknown_category lists the valid categories).
• 404: no public listing with that id.
• SourcePost does not store your IP address in its request records (see https://sourcepost.dev/privacy).

More

• llms.txt: short description of SourcePost.
• OpenAPI: every endpoint, parameter and field.
• MCP: https://sourcepost.dev/mcp — MCP server (streamable HTTP, no key) with the tools search_listings, get_listing and send_interest; same results as the API.