integrate-nowyourlink-api
Installation
SKILL.md
Integrate the nowyourlink public API
Use this skill when a developer wants to add nowyourlink Spotlight reads to an application, script or agent configuration. Everything below is anonymous and read-only.
Pick the integration path
| Need | Use |
|---|---|
| Node.js 22+ application | npm install nowyourlink-agent-kit, then import { SpotlightClient } from "nowyourlink-agent-kit" |
| Shell or CI lookup | npx nowyourlink-agent-kit current, list --limit 5, or day YYYY-MM-DD; JSON on stdout, errors as JSON on stderr with exit code 1 |
| Python 3.10+ application | python -m pip install nowyourlink-spotlights; standard library only |
| Typed client generation | OpenAPI 3.1 at https://nowyourlink.com/openapi.json (URL versioning at /api/v1) |
| Agent client with MCP | Streamable HTTP server at https://nowyourlink.com/mcp; add the entry from mcp.json in this kit |
| Plain HTTP | GET https://nowyourlink.com/api/v1/spotlight, /api/v1/spotlights, /api/v1/spotlights/YYYY-MM-DD |