@apteva/integrations 0.15.10 → 0.15.12

package/src/apps/jungle-scout.json

@@ -0,0 +1,166 @@
+{
+  "slug": "jungle-scout",
+  "name": "Jungle Scout",
+  "description": "Jungle Scout Public API for Amazon product research: product database queries, keyword discovery by ASIN or seed keyword, historical search volume, sales estimates, and share of voice.",
+  "logo": "https://www.google.com/s2/favicons?domain=junglescout.com&sz=128",
+  "categories": ["amazon", "seo", "marketplace", "ecommerce", "keywords", "product-research"],
+  "base_url": "https://developer.junglescout.com",
+  "auth": {
+    "types": ["api_key"],
+    "headers": {
+      "Authorization": "{{key_name}}:{{api_key}}",
+      "X-API-Type": "{{api_type}}",
+      "Accept": "application/vnd.junglescout.v1+json",
+      "Content-Type": "application/vnd.api+json"
+    },
+    "credential_fields": [
+      {
+        "name": "key_name",
+        "label": "Key Name",
+        "description": "Jungle Scout API key name from the Developer page."
+      },
+      {
+        "name": "api_key",
+        "label": "API Key",
+        "description": "Jungle Scout API key. The Authorization header is KEY_NAME:API_KEY."
+      },
+      {
+        "name": "api_type",
+        "label": "API Type",
+        "description": "Use junglescout for JS accounts or cobalt for Enterprise accounts."
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "query_product_database",
+      "description": "Search Jungle Scout's Amazon product database using product filters or ASIN/title keywords. Use this for product research, niche discovery, revenue/sales/review filters, seller type, category, and availability filters. Body must be JSON:API data with type product_database_query and attributes.",
+      "method": "POST",
+      "path": "/api/product_database_query",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "marketplace": { "type": "string", "enum": ["us", "uk", "de", "in", "ca", "fr", "it", "es", "mx", "jp"], "description": "Amazon marketplace country code." },
+          "sort": { "type": "string", "description": "Sort field, e.g. revenue, -revenue, sales, -sales, reviews, -reviews, name, -name." },
+          "page_size": { "type": "integer", "description": "Results per page, max 100." },
+          "page_cursor": { "type": "string", "description": "Pagination cursor from links.next." },
+          "data": {
+            "type": "object",
+            "description": "JSON:API body. Example: {\"type\":\"product_database_query\",\"attributes\":{\"include_keywords\":[\"lamp\"],\"exclude_unavailable_products\":true,\"min_sales\":100}}."
+          }
+        },
+        "required": ["marketplace", "data"]
+      },
+      "query_params": ["marketplace", "sort"],
+      "query_param_aliases": {
+        "page_size": "page[size]",
+        "page_cursor": "page[cursor]"
+      }
+    },
+    {
+      "name": "keywords_by_asin",
+      "description": "Return keywords for which the queried ASINs appear in Amazon search results. Query up to 10 ASINs at a time and filter/sort by search volume, trend, PPC bid, ranking ease, relevancy, and organic product count.",
+      "method": "POST",
+      "path": "/api/keywords/keywords_by_asin_query",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "marketplace": { "type": "string", "enum": ["us", "uk", "de", "in", "ca", "fr", "it", "es", "mx", "jp"] },
+          "sort": { "type": "string", "description": "Sort field, default -monthly_search_volume_exact." },
+          "page_size": { "type": "integer", "description": "Results per page, max 100." },
+          "page_cursor": { "type": "string" },
+          "data": {
+            "type": "object",
+            "description": "JSON:API body with type keywords_by_asin_query and attributes such as asins plus optional filters."
+          }
+        },
+        "required": ["marketplace", "data"]
+      },
+      "query_params": ["marketplace", "sort"],
+      "query_param_aliases": {
+        "page_size": "page[size]",
+        "page_cursor": "page[cursor]"
+      }
+    },
+    {
+      "name": "keywords_by_keyword",
+      "description": "Return related Amazon keywords and metrics based on a seed keyword. Use this for Amazon keyword expansion, search volume, trends, PPC bids, ranking ease, relevancy, and organic product count.",
+      "method": "POST",
+      "path": "/api/keywords/keywords_by_keyword_query",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "marketplace": { "type": "string", "enum": ["us", "uk", "de", "in", "ca", "fr", "it", "es", "mx", "jp"] },
+          "sort": { "type": "string", "description": "Sort field, default -monthly_search_volume_exact." },
+          "page_size": { "type": "integer", "description": "Results per page, max 100." },
+          "page_cursor": { "type": "string" },
+          "data": {
+            "type": "object",
+            "description": "JSON:API body with type keywords_by_keyword_query and attributes such as keyword plus optional filters."
+          }
+        },
+        "required": ["marketplace", "data"]
+      },
+      "query_params": ["marketplace", "sort"],
+      "query_param_aliases": {
+        "page_size": "page[size]",
+        "page_cursor": "page[cursor]"
+      }
+    },
+    {
+      "name": "historical_search_volume",
+      "description": "Return exact keyword search volume in 7-day increments for a date range.",
+      "method": "GET",
+      "path": "/api/keywords/historical_search_volume",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "marketplace": { "type": "string", "enum": ["us", "uk", "de", "in", "ca", "fr", "it", "es", "mx", "jp"] },
+          "keyword": { "type": "string" },
+          "start_date": { "type": "string", "description": "Start date in YYYY-MM-DD." },
+          "end_date": { "type": "string", "description": "End date in YYYY-MM-DD." }
+        },
+        "required": ["marketplace", "keyword", "start_date", "end_date"]
+      },
+      "query_params": ["marketplace", "keyword", "start_date", "end_date"]
+    },
+    {
+      "name": "sales_estimates",
+      "description": "Return daily price, rank, and sales estimate data for an ASIN over a period. Variant ASINs return parent-ASIN aggregate estimates.",
+      "method": "GET",
+      "path": "/api/sales_estimates_query",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "marketplace": { "type": "string", "enum": ["us", "uk", "de", "in", "ca", "fr", "it", "es", "mx", "jp"] },
+          "asin": { "type": "string" },
+          "start_date": { "type": "string", "description": "Start date in YYYY-MM-DD." },
+          "end_date": { "type": "string", "description": "End date in YYYY-MM-DD. Must be before current date." }
+        },
+        "required": ["marketplace", "asin", "start_date", "end_date"]
+      },
+      "query_params": ["marketplace", "asin", "start_date", "end_date"]
+    },
+    {
+      "name": "share_of_voice",
+      "description": "For a keyword search on Amazon, return brand share across the first 3 result pages, including organic, sponsored, combined share of voice, PPC bid, 30-day search volume, and top-ASIN conversion-rate data.",
+      "method": "GET",
+      "path": "/api/share_of_voice",
+      "timeout_ms": 60000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "marketplace": { "type": "string", "enum": ["us", "uk", "de", "in", "ca", "fr", "it", "es", "mx", "jp"] },
+          "keyword": { "type": "string" }
+        },
+        "required": ["marketplace", "keyword"]
+      },
+      "query_params": ["marketplace", "keyword"]
+    }
+  ]
+}

package/src/apps/kling-ai.json

@@ -1,206 +1,242 @@
 {
   "slug": "kling-ai",
   "name": "Kling AI",
-  "description": "AI video generation with text-to-video, image-to-video, and video extension capabilities",
-  "logo": "https://www.google.com/s2/favicons?domain=klingai.com&sz=128",
-  "categories": [
-    "ai",
-    "video",
-    "generation",
-    "text-to-video",
-    "image-to-video"
-  ],
-  "base_url": "https://api.klingai.com",
+  "description": "KlingAI Open Platform API for async text-to-video, image-to-video, video extension, image generation, lip sync, and task polling. Uses bearer-token auth and official /v1 task endpoints.",
+  "logo": "https://www.google.com/s2/favicons?domain=kling.ai&sz=128",
+  "categories": ["ai", "video-generation", "image-generation", "text-to-video", "image-to-video"],
+  "base_url": "https://api-singapore.klingai.com",
   "auth": {
-    "types": [
-      "api_key"
-    ],
+    "types": ["bearer"],
     "headers": {
-      "x-api-key": "{{api_key}}"
+      "Authorization": "Bearer {{api_key}}",
+      "Content-Type": "application/json"
     },
     "credential_fields": [
       {
         "name": "api_key",
-        "label": "API Key"
+        "label": "API Key",
+        "type": "password",
+        "description": "KlingAI Open Platform API key. The Authorization header is sent as Bearer <key>."
       }
     ]
   },
   "tools": [
     {
-      "name": "generate_video",
-      "description": "Generate video from text prompt (text-to-video). Returns a task_id to check status.",
+      "name": "create_text_to_video_task",
+      "description": "Create a Kling text-to-video generation task. Returns task_id/task_status; poll get_text_to_video_task.",
+      "method": "POST",
+      "path": "/v1/videos/text2video",
+      "timeout_ms": 120000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model_name": { "type": "string", "description": "Kling video model id, e.g. kling-v2-1, kling-v2-1-master, kling-v2-5-turbo, kling-v3.", "default": "kling-v2-1" },
+          "prompt": { "type": "string", "description": "Video prompt." },
+          "negative_prompt": { "type": "string", "description": "Things to avoid." },
+          "cfg_scale": { "type": "number", "description": "Prompt adherence. Supported on older models.", "minimum": 0, "maximum": 1 },
+          "mode": { "type": "string", "description": "Quality/speed mode when supported.", "enum": ["std", "pro"] },
+          "camera_control": { "type": "object", "description": "Camera movement control object when supported by the selected model." },
+          "aspect_ratio": { "type": "string", "enum": ["16:9", "9:16", "1:1"] },
+          "duration": { "type": "string", "description": "Duration in seconds as a string for Kling API compatibility.", "enum": ["5", "10"] },
+          "callback_url": { "type": "string", "description": "Optional HTTPS callback URL for task completion." },
+          "external_task_id": { "type": "string", "description": "Optional caller-supplied id for idempotency/tracking." }
+        },
+        "required": ["prompt"]
+      }
+    },
+    {
+      "name": "get_text_to_video_task",
+      "description": "Get one Kling text-to-video task by task_id.",
+      "method": "GET",
+      "path": "/v1/videos/text2video/{task_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "task_id": { "type": "string" }
+        },
+        "required": ["task_id"]
+      }
+    },
+    {
+      "name": "list_text_to_video_tasks",
+      "description": "List Kling text-to-video tasks.",
+      "method": "GET",
+      "path": "/v1/videos/text2video",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "pageNum": { "type": "integer", "minimum": 1 },
+          "pageSize": { "type": "integer", "minimum": 1, "maximum": 500 }
+        }
+      }
+    },
+    {
+      "name": "create_image_to_video_task",
+      "description": "Create a Kling image-to-video generation task. image can be a URL or base64/data URI according to Kling account support.",
+      "method": "POST",
+      "path": "/v1/videos/image2video",
+      "timeout_ms": 120000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model_name": { "type": "string", "description": "Kling video model id, e.g. kling-v2-1, kling-v2-1-master, kling-v2-5-turbo, kling-v3.", "default": "kling-v2-1" },
+          "image": { "type": "string", "description": "First-frame image URL/base64/data URI." },
+          "image_tail": { "type": "string", "description": "Optional last-frame image URL/base64/data URI." },
+          "prompt": { "type": "string", "description": "Motion/action prompt." },
+          "negative_prompt": { "type": "string" },
+          "cfg_scale": { "type": "number", "minimum": 0, "maximum": 1 },
+          "mode": { "type": "string", "enum": ["std", "pro"] },
+          "static_mask": { "type": "string", "description": "Optional static mask image when supported." },
+          "dynamic_masks": { "type": "array", "description": "Optional dynamic masks when supported.", "items": { "type": "object" } },
+          "camera_control": { "type": "object" },
+          "duration": { "type": "string", "enum": ["5", "10"] },
+          "callback_url": { "type": "string" },
+          "external_task_id": { "type": "string" }
+        },
+        "required": ["image"]
+      }
+    },
+    {
+      "name": "get_image_to_video_task",
+      "description": "Get one Kling image-to-video task by task_id.",
+      "method": "GET",
+      "path": "/v1/videos/image2video/{task_id}",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "task_id": { "type": "string" }
+        },
+        "required": ["task_id"]
+      }
+    },
+    {
+      "name": "list_image_to_video_tasks",
+      "description": "List Kling image-to-video tasks.",
       "method": "GET",
-      "path": "/generate-video",
+      "path": "/v1/videos/image2video",
       "input_schema": {
         "type": "object",
         "properties": {
-          "prompt": {
-            "type": "string",
-            "description": "Video description (max 2500 chars)"
-          },
-          "negative_prompt": {
-            "type": "string",
-            "description": "Elements to exclude from video"
-          },
-          "duration": {
-            "type": "integer",
-            "description": "Video duration in seconds",
-            "enum": [
-              5,
-              10
-            ],
-            "default": 5
-          },
-          "aspect_ratio": {
-            "type": "string",
-            "description": "Video aspect ratio",
-            "enum": [
-              "16:9",
-              "9:16",
-              "1:1"
-            ],
-            "default": "16:9"
-          },
-          "mode": {
-            "type": "string",
-            "description": "Quality mode",
-            "enum": [
-              "std",
-              "pro"
-            ],
-            "default": "std"
-          },
-          "version": {
-            "type": "string",
-            "description": "Model version",
-            "enum": [
-              "1.5",
-              "1.6",
-              "2.1",
-              "2.5",
-              "2.6"
-            ],
-            "default": "2.1"
-          },
-          "enable_audio": {
-            "type": "boolean",
-            "description": "Generate audio track",
-            "default": false
-          }
+          "pageNum": { "type": "integer", "minimum": 1 },
+          "pageSize": { "type": "integer", "minimum": 1, "maximum": 500 }
+        }
+      }
+    },
+    {
+      "name": "create_video_extend_task",
+      "description": "Extend a completed Kling video task when the selected model/account supports video extension.",
+      "method": "POST",
+      "path": "/v1/videos/video-extend",
+      "timeout_ms": 120000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "video_id": { "type": "string", "description": "Kling video id or source task video id to extend." },
+          "prompt": { "type": "string", "description": "Extension prompt." },
+          "negative_prompt": { "type": "string" },
+          "callback_url": { "type": "string" },
+          "external_task_id": { "type": "string" }
         },
-        "required": [
-          "prompt"
-        ]
+        "required": ["video_id"]
       }
     },
     {
-      "name": "image_to_video",
-      "description": "Generate video from an image. Returns a task_id to check status.",
+      "name": "get_video_extend_task",
+      "description": "Get one Kling video extension task by task_id.",
       "method": "GET",
-      "path": "/image-to-video",
+      "path": "/v1/videos/video-extend/{task_id}",
       "input_schema": {
         "type": "object",
         "properties": {
-          "image_url": {
-            "type": "string",
-            "description": "URL of the source image (<10MB, min 300px sides)"
-          },
-          "prompt": {
-            "type": "string",
-            "description": "Optional motion/action description"
-          },
-          "negative_prompt": {
-            "type": "string",
-            "description": "Elements to exclude from video"
-          },
-          "duration": {
-            "type": "integer",
-            "description": "Video duration in seconds",
-            "enum": [
-              5,
-              10
-            ],
-            "default": 5
-          },
-          "mode": {
-            "type": "string",
-            "description": "Quality mode",
-            "enum": [
-              "std",
-              "pro"
-            ],
-            "default": "std"
-          },
-          "version": {
-            "type": "string",
-            "description": "Model version",
-            "enum": [
-              "1.5",
-              "1.6",
-              "2.1",
-              "2.5",
-              "2.6"
-            ],
-            "default": "2.1"
-          },
-          "image_tail_url": {
-            "type": "string",
-            "description": "End frame image URL for guided generation"
-          },
-          "enable_audio": {
-            "type": "boolean",
-            "description": "Generate audio track",
-            "default": false
-          }
+          "task_id": { "type": "string" }
         },
-        "required": [
-          "image_url"
-        ]
+        "required": ["task_id"]
       }
     },
     {
-      "name": "get_task",
-      "description": "Get the status and result of a video generation task",
+      "name": "create_image_generation_task",
+      "description": "Create a Kling text-to-image/image-generation task.",
+      "method": "POST",
+      "path": "/v1/images/generations",
+      "timeout_ms": 120000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "model_name": { "type": "string", "description": "Kling image model id." },
+          "prompt": { "type": "string" },
+          "negative_prompt": { "type": "string" },
+          "image": { "type": "string", "description": "Optional reference image URL/base64/data URI when supported." },
+          "aspect_ratio": { "type": "string", "enum": ["16:9", "9:16", "1:1", "4:3", "3:4", "3:2", "2:3"] },
+          "n": { "type": "integer", "description": "Number of images.", "minimum": 1, "maximum": 4 },
+          "callback_url": { "type": "string" },
+          "external_task_id": { "type": "string" }
+        },
+        "required": ["prompt"]
+      }
+    },
+    {
+      "name": "get_image_generation_task",
+      "description": "Get one Kling image generation task by task_id.",
       "method": "GET",
-      "path": "/get-task",
+      "path": "/v1/images/generations/{task_id}",
       "input_schema": {
         "type": "object",
         "properties": {
-          "task_id": {
-            "type": "string",
-            "description": "Task ID from generate-video or image-to-video"
-          }
+          "task_id": { "type": "string" }
         },
-        "required": [
-          "task_id"
-        ]
+        "required": ["task_id"]
+      }
+    },
+    {
+      "name": "list_image_generation_tasks",
+      "description": "List Kling image generation tasks.",
+      "method": "GET",
+      "path": "/v1/images/generations",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "pageNum": { "type": "integer", "minimum": 1 },
+          "pageSize": { "type": "integer", "minimum": 1, "maximum": 500 }
+        }
       }
     },
     {
-      "name": "extend_video",
-      "description": "Extend an existing video by 4.5 seconds",
+      "name": "create_lip_sync_task",
+      "description": "Create a Kling lip sync task from source video and audio/text when available for the account.",
+      "method": "POST",
+      "path": "/v1/videos/lip-sync",
+      "timeout_ms": 120000,
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "video_id": { "type": "string", "description": "Source video id." },
+          "video_url": { "type": "string", "description": "Source video URL if the endpoint is configured for URL input." },
+          "audio_url": { "type": "string", "description": "Driving audio URL." },
+          "text": { "type": "string", "description": "Text to synthesize/sync when supported." },
+          "voice_id": { "type": "string", "description": "Voice id for text-driven lip sync when supported." },
+          "callback_url": { "type": "string" },
+          "external_task_id": { "type": "string" }
+        }
+      }
+    },
+    {
+      "name": "get_lip_sync_task",
+      "description": "Get one Kling lip sync task by task_id.",
       "method": "GET",
-      "path": "/extend-video",
+      "path": "/v1/videos/lip-sync/{task_id}",
       "input_schema": {
         "type": "object",
         "properties": {
-          "origin_task_id": {
-            "type": "string",
-            "description": "Task ID of the original video to extend"
-          },
-          "prompt": {
-            "type": "string",
-            "description": "Optional prompt for the extension"
-          },
-          "negative_prompt": {
-            "type": "string",
-            "description": "Elements to exclude"
-          }
+          "task_id": { "type": "string" }
         },
-        "required": [
-          "origin_task_id"
-        ]
+        "required": ["task_id"]
       }
     }
-  ]
-}
+  ],
+  "webhooks": {
+    "registrar": {
+      "manual_setup": "Kling supports per-task callbacks through callback_url on task creation. There is no durable account-level webhook registration route in this catalog."
+    },
+    "events": ["task.succeed", "task.failed"]
+  }
+}

package/src/apps/ko-fi.json

@@ -0,0 +1,34 @@
+{
+  "slug": "ko-fi",
+  "name": "Ko-fi",
+  "description": "Ko-fi creator-commerce webhook integration for payment, donation, shop order, membership, and commission notifications. Ko-fi does not expose a full public catalog/product API for agents to create products or upload audio files.",
+  "logo": "https://www.google.com/s2/favicons?domain=ko-fi.com&sz=128",
+  "categories": ["payments", "commerce", "creator-economy", "donations", "memberships", "webhooks"],
+  "base_url": "https://ko-fi.com",
+  "auth": {
+    "types": ["api_key"],
+    "headers": {},
+    "credential_fields": [
+      {
+        "name": "verificationToken",
+        "label": "Verification Token",
+        "required": false,
+        "description": "Optional Ko-fi verification token used to match incoming webhook payloads."
+      }
+    ]
+  },
+  "tools": [],
+  "webhooks": {
+    "signature_header": "",
+    "registration": {
+      "manual_setup": "Copy the Apteva webhook URL into Ko-fi's API/Webhooks settings. Ko-fi webhook setup is manual; this integration stores the optional verification token for matching incoming payment payloads."
+    },
+    "events": [
+      { "name": "payment", "description": "A Ko-fi payment notification such as donation, membership, shop order, or commission, depending on enabled Ko-fi features." },
+      { "name": "donation", "description": "A donation-style Ko-fi payment." },
+      { "name": "membership", "description": "A Ko-fi membership payment." },
+      { "name": "shop_order", "description": "A Ko-fi shop order payment." },
+      { "name": "commission", "description": "A Ko-fi commission payment." }
+    ]
+  }
+}