@apteva/integrations 0.3.62 → 0.15.3

package/src/apps/spotify-ads.json

@@ -0,0 +1,231 @@
+{
+  "slug": "spotify-ads",
+  "name": "Spotify Ad Studio",
+  "description": "Spotify Ad Studio Partner API — manage ad accounts, campaigns, ad sets, ads, and pull audio/video/podcast ad reports. Access is gated: applicants must join Spotify's Advertising Partner Program (https://ads.spotify.com/en-US/partner-program/) before API credentials are issued. Until granted, treat this template as a stub: shape, scopes, and base_url are accurate; the platform may rename endpoints when they release a public version.",
+  "logo": "https://www.google.com/s2/favicons?domain=ads.spotify.com&sz=128",
+  "categories": [
+    "advertising",
+    "marketing",
+    "campaigns",
+    "audio-ads",
+    "podcast-ads",
+    "spotify",
+    "streaming"
+  ],
+  "base_url": "https://ads.spotify.com/api/v1",
+  "auth": {
+    "types": [
+      "bearer",
+      "oauth2"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}",
+      "Content-Type": "application/json"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "access_token",
+        "type": "password"
+      },
+      {
+        "name": "refresh_token",
+        "label": "refresh_token",
+        "type": "password"
+      },
+      {
+        "name": "expires_in",
+        "label": "expires_in"
+      },
+      {
+        "name": "ad_account_id",
+        "label": "Default Ad Account ID"
+      }
+    ],
+    "oauth2": {
+      "authorize_url": "https://accounts.spotify.com/authorize",
+      "token_url": "https://accounts.spotify.com/api/token",
+      "scopes": [
+        "ads-api-read",
+        "ads-api-write"
+      ],
+      "client_id_required": true,
+      "pkce": true
+    }
+  },
+  "tools": [
+    {
+      "name": "list_ad_accounts",
+      "description": "List ad accounts the authenticated partner user can access.",
+      "method": "GET",
+      "path": "/ad_accounts",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": { "type": "integer", "default": 50 },
+          "offset": { "type": "integer", "default": 0 }
+        }
+      }
+    },
+    {
+      "name": "list_campaigns",
+      "description": "List campaigns under an ad account.",
+      "method": "GET",
+      "path": "/ad_accounts/{ad_account_id}/campaigns",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "status": { "type": "string", "enum": ["ACTIVE", "PAUSED", "ARCHIVED", "DRAFT"] },
+          "limit": { "type": "integer", "default": 50 },
+          "offset": { "type": "integer", "default": 0 }
+        },
+        "required": ["ad_account_id"]
+      }
+    },
+    {
+      "name": "create_campaign",
+      "description": "Create a campaign. objective: AUDIO_REACH | VIDEO_VIEWS | PODCAST_AWARENESS | WEBSITE_VISITS | CONVERSIONS. Required: name, objective, budget {amount, currency, type: DAILY|LIFETIME}, start_date, status.",
+      "method": "POST",
+      "path": "/ad_accounts/{ad_account_id}/campaigns",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "name": { "type": "string" },
+          "objective": { "type": "string", "enum": ["AUDIO_REACH", "VIDEO_VIEWS", "PODCAST_AWARENESS", "WEBSITE_VISITS", "CONVERSIONS"] },
+          "budget": { "type": "object" },
+          "start_date": { "type": "string", "description": "yyyy-MM-dd" },
+          "end_date": { "type": "string" },
+          "status": { "type": "string", "enum": ["ACTIVE", "PAUSED", "DRAFT"], "default": "DRAFT" }
+        },
+        "required": ["ad_account_id", "name", "objective", "budget", "start_date"]
+      }
+    },
+    {
+      "name": "update_campaign",
+      "description": "Update a campaign by id (PATCH semantics).",
+      "method": "PATCH",
+      "path": "/ad_accounts/{ad_account_id}/campaigns/{campaign_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "campaign_id": { "type": "string" },
+          "name": { "type": "string" },
+          "budget": { "type": "object" },
+          "end_date": { "type": "string" },
+          "status": { "type": "string", "enum": ["ACTIVE", "PAUSED", "ARCHIVED"] }
+        },
+        "required": ["ad_account_id", "campaign_id"]
+      }
+    },
+    {
+      "name": "list_ad_sets",
+      "description": "List ad sets (audience + targeting + bidding) under a campaign.",
+      "method": "GET",
+      "path": "/ad_accounts/{ad_account_id}/campaigns/{campaign_id}/ad_sets",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "campaign_id": { "type": "string" },
+          "limit": { "type": "integer", "default": 50 },
+          "offset": { "type": "integer", "default": 0 }
+        },
+        "required": ["ad_account_id", "campaign_id"]
+      }
+    },
+    {
+      "name": "create_ad_set",
+      "description": "Create an ad set under a campaign. Required: name, targeting {countries[], age_ranges[], genders[], languages[]}, bidding {strategy (CPC|CPM|CPCV), bid_amount?}, ad_format (AUDIO|VIDEO|PODCAST), placements[].",
+      "method": "POST",
+      "path": "/ad_accounts/{ad_account_id}/campaigns/{campaign_id}/ad_sets",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "campaign_id": { "type": "string" },
+          "name": { "type": "string" },
+          "targeting": { "type": "object" },
+          "bidding": { "type": "object" },
+          "ad_format": { "type": "string", "enum": ["AUDIO", "VIDEO", "PODCAST"] },
+          "placements": { "type": "array", "items": { "type": "string" } },
+          "status": { "type": "string", "enum": ["ACTIVE", "PAUSED", "DRAFT"], "default": "DRAFT" }
+        },
+        "required": ["ad_account_id", "campaign_id", "name", "targeting", "bidding", "ad_format"]
+      }
+    },
+    {
+      "name": "list_ads",
+      "description": "List ads under an ad set.",
+      "method": "GET",
+      "path": "/ad_accounts/{ad_account_id}/ad_sets/{ad_set_id}/ads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "ad_set_id": { "type": "string" },
+          "limit": { "type": "integer", "default": 50 },
+          "offset": { "type": "integer", "default": 0 }
+        },
+        "required": ["ad_account_id", "ad_set_id"]
+      }
+    },
+    {
+      "name": "create_ad",
+      "description": "Create an ad. creative_id references an asset uploaded via the Asset Manager. Required: name, creative_id, click_url, status.",
+      "method": "POST",
+      "path": "/ad_accounts/{ad_account_id}/ad_sets/{ad_set_id}/ads",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "ad_set_id": { "type": "string" },
+          "name": { "type": "string" },
+          "creative_id": { "type": "string" },
+          "click_url": { "type": "string" },
+          "voice_track_url": { "type": "string", "description": "For audio ads — pre-uploaded MP3" },
+          "companion_image_url": { "type": "string" },
+          "status": { "type": "string", "enum": ["ACTIVE", "PAUSED", "DRAFT"], "default": "DRAFT" }
+        },
+        "required": ["ad_account_id", "ad_set_id", "name", "creative_id", "click_url"]
+      }
+    },
+    {
+      "name": "list_creatives",
+      "description": "List creatives (uploaded audio, video, image, podcast assets) under an ad account.",
+      "method": "GET",
+      "path": "/ad_accounts/{ad_account_id}/creatives",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "type": { "type": "string", "enum": ["AUDIO", "VIDEO", "IMAGE", "PODCAST"] },
+          "limit": { "type": "integer", "default": 50 },
+          "offset": { "type": "integer", "default": 0 }
+        },
+        "required": ["ad_account_id"]
+      }
+    },
+    {
+      "name": "campaign_report",
+      "description": "Pull campaign-level performance. metrics: impressions, listens, completion_rate, clicks, ctr, spend, frequency, reach, cpm, cpc, video_completions. granularity: TOTAL|DAILY|WEEKLY|MONTHLY. breakdown: gender, age, country, device, placement.",
+      "method": "POST",
+      "path": "/ad_accounts/{ad_account_id}/reports/campaigns",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "ad_account_id": { "type": "string" },
+          "campaign_ids": { "type": "array", "items": { "type": "string" } },
+          "start_date": { "type": "string", "description": "yyyy-MM-dd" },
+          "end_date": { "type": "string" },
+          "metrics": { "type": "array", "items": { "type": "string" } },
+          "granularity": { "type": "string", "enum": ["TOTAL", "DAILY", "WEEKLY", "MONTHLY"], "default": "DAILY" },
+          "breakdown": { "type": "string", "enum": ["gender", "age", "country", "device", "placement"] }
+        },
+        "required": ["ad_account_id", "start_date", "end_date", "metrics"]
+      }
+    }
+  ]
+}

package/src/apps/steel.json

@@ -0,0 +1,239 @@
+{
+  "slug": "steel",
+  "name": "Steel",
+  "description": "Steel.dev open-source headless browser API for AI agents. Spin up cloud browser sessions, capture cookies/storage as reusable contexts, or hit one-shot scrape/screenshot/PDF endpoints without managing a session.",
+  "logo": "https://www.google.com/s2/favicons?domain=steel.dev&sz=128",
+  "categories": [
+    "browser-automation",
+    "scraping",
+    "ai-agents",
+    "headless-browser",
+    "screenshots",
+    "pdf"
+  ],
+  "base_url": "https://api.steel.dev",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "steel-api-key": "{{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "API Key",
+        "description": "Steel API key from https://app.steel.dev (Settings > API Keys)."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "create_session",
+      "description": "Create a new cloud browser session. Returns a session ID and a websocket URL (wss://connect.steel.dev?apiKey=...&sessionId=...) that Playwright/Puppeteer can connect to. Sessions persist cookies, localStorage, and tabs until released.",
+      "method": "POST",
+      "path": "/v1/sessions",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "sessionTimeout": {
+            "type": "integer",
+            "description": "Maximum session duration in seconds before auto-release."
+          },
+          "useProxy": {
+            "type": "boolean",
+            "description": "Route session traffic through Steel's residential proxy."
+          },
+          "solveCaptcha": {
+            "type": "boolean",
+            "description": "Enable Steel's automatic CAPTCHA solver."
+          },
+          "userAgent": {
+            "type": "string",
+            "description": "Custom user-agent string."
+          },
+          "region": {
+            "type": "string",
+            "description": "Region for the browser instance (e.g. 'us-east-1', 'eu-west-1')."
+          },
+          "blockAds": {
+            "type": "boolean"
+          }
+        }
+      }
+    },
+    {
+      "name": "list_sessions",
+      "description": "List recent browser sessions for the account.",
+      "method": "GET",
+      "path": "/v1/sessions",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "status": {
+            "type": "string",
+            "description": "Filter by session status (e.g. 'live', 'released').",
+            "enum": [
+              "live",
+              "released",
+              "failed"
+            ]
+          },
+          "limit": {
+            "type": "integer"
+          }
+        }
+      }
+    },
+    {
+      "name": "get_session",
+      "description": "Retrieve details for a specific session: status, websocket URL, region, debug URL.",
+      "method": "GET",
+      "path": "/v1/sessions/{id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Session ID."
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "release_session",
+      "description": "End a live session and free its resources. Released sessions can no longer be connected to but their context (cookies/storage) and recordings remain available.",
+      "method": "POST",
+      "path": "/v1/sessions/{id}/release",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Session ID."
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "get_session_context",
+      "description": "Fetch the persisted browser context (cookies, localStorage, sessionStorage) for a session. Useful for extracting login state to reuse later.",
+      "method": "GET",
+      "path": "/v1/sessions/{id}/context",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Session ID."
+          }
+        },
+        "required": [
+          "id"
+        ]
+      }
+    },
+    {
+      "name": "scrape",
+      "description": "One-shot scrape of a URL — Steel handles the browser, returns cleaned content. No session management needed. Returns text, HTML, markdown, or all three depending on format.",
+      "method": "POST",
+      "path": "/v1/scrape",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "description": "URL to scrape."
+          },
+          "format": {
+            "type": "array",
+            "items": {
+              "type": "string",
+              "enum": [
+                "html",
+                "markdown",
+                "readability",
+                "cleaned_html"
+              ]
+            },
+            "description": "Output formats to return."
+          },
+          "waitFor": {
+            "type": "integer",
+            "description": "Milliseconds to wait after page load before capturing content."
+          },
+          "useProxy": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "url"
+        ]
+      }
+    },
+    {
+      "name": "screenshot",
+      "description": "One-shot screenshot of a URL. Returns a PNG image (binary or base64 depending on response handling).",
+      "method": "POST",
+      "path": "/v1/screenshot",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "description": "URL to screenshot."
+          },
+          "fullPage": {
+            "type": "boolean",
+            "description": "Capture the full scrollable page rather than just the viewport."
+          },
+          "viewport": {
+            "type": "object",
+            "description": "Viewport size, e.g. { width: 1280, height: 720 }."
+          },
+          "delay": {
+            "type": "integer",
+            "description": "Milliseconds to wait before capturing."
+          }
+        },
+        "required": [
+          "url"
+        ]
+      }
+    },
+    {
+      "name": "pdf",
+      "description": "One-shot render of a URL to PDF. Returns a PDF file.",
+      "method": "POST",
+      "path": "/v1/pdf",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "url": {
+            "type": "string",
+            "description": "URL to render."
+          },
+          "format": {
+            "type": "string",
+            "description": "Paper format (e.g. 'A4', 'Letter')."
+          },
+          "landscape": {
+            "type": "boolean"
+          },
+          "printBackground": {
+            "type": "boolean"
+          }
+        },
+        "required": [
+          "url"
+        ]
+      }
+    }
+  ]
+}

package/src/apps/stocktwits.json

@@ -0,0 +1,120 @@
+{
+  "slug": "stocktwits",
+  "name": "Stocktwits",
+  "description": "Twitter-shaped social network for traders, organized by ticker cashtags ($AAPL, $TSLA, $NVDA). Provides per-ticker message streams + a bullish/bearish sentiment label many posters self-tag with — useful for gauging retail mood, mention-volume spikes (often a contrarian signal at extremes), and discovering what tickers are getting unusual attention. Reads work without auth at limited rate; supply an access_token to raise limits. Get one at https://stocktwits.com/developers/docs.",
+  "logo": "https://www.google.com/s2/favicons?domain=stocktwits.com&sz=128",
+  "categories": [
+    "stocks",
+    "sentiment",
+    "social",
+    "retail",
+    "crypto"
+  ],
+  "base_url": "https://api.stocktwits.com/api/2",
+  "auth": {
+    "types": ["api_key"],
+    "query_params": {
+      "access_token": "{{access_token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "access_token",
+        "label": "Access Token (optional)",
+        "description": "OAuth access_token from https://stocktwits.com/developers/apps. Optional — public reads work without it, but rate limits are much tighter (200/hour without token vs 400+/hour with).",
+        "required": false
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "symbol_stream",
+      "description": "Recent messages tagged with one ticker. Each message includes id, body, sentiment ('Bullish' / 'Bearish' / null), user (with follower count + ideas count + watchlist count), created_at, and any links. Use to read the retail crowd's take on a name and to count bullish-vs-bearish posts as a rough sentiment ratio.",
+      "method": "GET",
+      "path": "/streams/symbol/{symbol}.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "symbol": {"type": "string", "description": "Ticker without $ prefix — AAPL, TSLA, BTC.X (crypto)."},
+          "since":  {"type": "integer", "description": "Return messages with id > this (for incremental polling)."},
+          "max":    {"type": "integer", "description": "Return messages with id <= this (for paging backwards)."},
+          "limit":  {"type": "integer", "default": 30, "description": "Max messages (1-30)."}
+        },
+        "required": ["symbol"]
+      }
+    },
+    {
+      "name": "trending_symbols",
+      "description": "Top trending tickers across Stocktwits right now — the names retail is buzzing about. Useful for discovery of where unusual attention is concentrating; surge of trending = often precedes price movement (any direction).",
+      "method": "GET",
+      "path": "/trending/symbols.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "limit": {"type": "integer", "description": "Max symbols, default 30."}
+        }
+      }
+    },
+    {
+      "name": "trending_stream",
+      "description": "Messages flowing through the platform's overall 'trending' stream — like trending_symbols but as message-level granularity. Use for general retail sentiment headlines.",
+      "method": "GET",
+      "path": "/streams/trending.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "since": {"type": "integer"},
+          "max":   {"type": "integer"},
+          "limit": {"type": "integer", "default": 30}
+        }
+      }
+    },
+    {
+      "name": "search_symbols",
+      "description": "Find tickers matching a query — useful when an agent has a company name but not a ticker.",
+      "method": "GET",
+      "path": "/search/symbols.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "q":     {"type": "string", "description": "Search term — 'apple', 'nvidia', 'palantir'."}
+        },
+        "required": ["q"]
+      }
+    },
+    {
+      "name": "user_stream",
+      "description": "Messages from a specific Stocktwits user — useful for following known smart-money or contrarian-indicator accounts.",
+      "method": "GET",
+      "path": "/streams/user/{username}.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "username": {"type": "string", "description": "Stocktwits username without leading @."},
+          "since":    {"type": "integer"},
+          "max":      {"type": "integer"},
+          "limit":    {"type": "integer", "default": 30}
+        },
+        "required": ["username"]
+      }
+    },
+    {
+      "name": "watchlist_stream",
+      "description": "Messages mentioning any symbol in a public watchlist. Useful for thematic monitoring (e.g. a watchlist of AI semiconductors → one query returns the chatter across all of them).",
+      "method": "GET",
+      "path": "/streams/watchlist/{watchlist_id}.json",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "watchlist_id": {"type": "string"},
+          "since":        {"type": "integer"},
+          "max":          {"type": "integer"},
+          "limit":        {"type": "integer"}
+        },
+        "required": ["watchlist_id"]
+      }
+    }
+  ],
+  "health_check": {
+    "tool": "trending_symbols"
+  }
+}