Skip to content
TakoAPI
Back to skills

shipp

by kclonts

Git & GitHub
—Not yet rated
Your rating

Brief

Shipp is a real-time data connector.

Description

What This Skill Does

Shipp is a real-time data connector for live external data such as sports schedules and in-game events. It provides a REST API with JSON responses, authenticated via API key. Connections are created once and polled repeatedly using cursor-based pagination.

Cursor-based pagination via since_event_id means each poll returns only new events, avoiding re-processing duplicates without any client-side diffing logic.

When to Use It

  • Tracking live NBA play-by-play events during a game
  • Building a sports dashboard that updates scores every 10 seconds
  • Fetching tonight's NFL schedule to discover game IDs before creating a connection
  • Polling live soccer match events to trigger automated bets on a prediction market
  • Alerting when a specific MLB team scores in the current inning

Example Workflow

INPUT

User asks: Stream live play-by-play events for tonight's Lakers game

AGENT
  1. 1

    Calls GET /api/v1/sports/nba/schedule to find the game_id and team names

  2. 2

    Creates a connection via POST /api/v1/connections/create with filter_instructions describing the target game

  3. 3

    Stores the returned connection_id for reuse across all subsequent polls

  4. 4

    Polls POST /api/v1/connections/{connectionId} on a 10-second interval, passing the latest since_event_id as a cursor

  5. 5

    Defensively reads schema-flexible fields from data[], deduplicates by event ID, and surfaces new events to the user

OUTPUT

Continuous stream of new play-by-play events for the specified game, deduplicated and formatted

Requirements

  • Shipp API key from platform.shipp.ai

Installation

clawhub install kclonts/shipp

Run the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.

Links