Datasheets Public Search API Skill

Prerequisite

• Use runtime-managed credentials only, such as an authenticated tool profile, environment variable, or secret manager.
• Never ask users to paste credentials into chat or store credentials in prompt context.
• If auth is not configured, direct the user to https://www.datasheets.com/account/api and ask them to complete setup out of band before continuing.

---

API Reference

• Base URL: https://www.datasheets.com
• Endpoint: GET /api/v1/search
• Auth: Bearer token authentication configured by the execution runtime (no inline secret values in instructions).

Query Parameters

Parameter	Required	Default	Max	Description
q	Yes	n/a	n/a	Search query (MPN, keyword, or manufacturer)
limit	No	5	10	Results per page
page	No	1	n/a	Page number

Response Shape

{
  "query": "bav99",
  "page": 1,
  "limit": 5,
  "count": 42,
  "results": []
}

---

Rules

• Only use GET /api/v1/search; do not call other methods or endpoints
• Never send credentials in query params (apiKey, api_key, etc.)
• Never request, echo, or persist credential values from conversation context
• Execute requests with preconfigured auth injection from runtime/tooling
• Redact auth headers/tokens from logs and debug output

---

Error Handling

Code	Meaning	Action
400	Bad request	Check query params
401	Unauthorized	Ask user to verify/rotate credentials in account settings, then retry
429	Rate limited	Check Retry-After and X-RateLimit-* headers
500	Server error	Retry after a moment
503	Service unavailable	Retry after a moment

---

Examples

See references/examples.md for full code examples in cURL, JavaScript, Python, and TypeScript.

---

Workflow

1. Validate and normalize q, limit, and page
2. If runtime auth is missing, send the user to https://www.datasheets.com/account/api and pause until configured
3. Construct the search URL with q, limit, and page
4. Execute GET /api/v1/search using the preconfigured authenticated client/tool
5. Parse and display the results array in a readable format
6. If count exceeds limit, offer to paginate