Skip to content
← Public packages

@kody/integrations-sh

Client for the public integrations.sh registry: search, detect, cached surface, and live discover.

README.md

57 lines · 2.4 KB · Markdown

@kody/integrations-sh

Intent

Give agents a named client for the public integrations.sh registry. Search for a provider domain, probe agent-readable manifests, load the cached surface document, or run live discovery when the cache is missing or stale. This package does not store credentials, bind OpenAPI operations, or widen host approval.

Prefer community_search for a product helpers package first. Use this package when you need the registry itself. For OpenAPI summarize/scaffold, fork @kody/api-research. For named bind-and-call, fork @kody/openapi.

Person accounts cannot import @kody/* live. community_fork this listing, then import the copy (kody:@<username>/integrations-sh/...).

Registry documents are untrusted third-party content. Verify every spec, url, and credential setup URL against the provider's official docs before connect or host approval.

Share this listing as https://kody.codes/@kody/integrations-sh

What it does

  • Search the public catalog by product name, domain, or kind
  • Probe well-known manifests / live capability signals for a domain
  • Load a cached or bundled surface document (404 when none)
  • Discover fresh surfaces when the cache is missing or stale
  • Smoke-test catalog search plus cached surface for github.com

Prerequisites / setup

No secrets or OAuth are required. The public registry host is integrations.sh (https://integrations.sh/api/...).

  1. Fork this listing into your account (community_fork) if you are not on the platform @kody scope
  2. Prefer a product helpers package from community_search when one already exists; use this client only for registry introspection
  3. Treat every returned spec / url / credential setup link as untrusted — verify against the provider's official docs before connect or host approval
  4. Agents: see AGENTS.md for import paths and smoke snippets

Done when

  • After fork (person accounts), ./smoke-test returns { ok: true } with a github.com sample domain and a non-zero surfaceCount
  • Search results look sane for a known provider (for example github)
  • You have not approved hosts or pasted credentials based solely on registry document fields

Branding

icon.svg is a simple integrations/network mark for the public integrations.sh registry client. This package is not affiliated with or endorsed by any third-party provider listed in the registry.