@apteva/integrations 0.2.3 → 0.3.1

package/src/apps/bitly.json

@@ -0,0 +1,175 @@
+{
+  "slug": "bitly",
+  "name": "Bitly",
+  "description": "Bitly URL shortening and link management platform. Shorten URLs, retrieve link details, manage bitlinks, and access click analytics.",
+  "logo": "https://www.google.com/s2/favicons?domain=bitly.com&sz=128",
+  "categories": [
+    "url-shortener",
+    "links",
+    "analytics",
+    "marketing",
+    "tracking"
+  ],
+  "base_url": "https://api-ssl.bitly.com/v4",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "accessToken",
+        "label": "Access Token",
+        "description": "Bitly access token (generate at app.bitly.com/settings/api)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "shorten_url",
+      "description": "Shorten a long URL into a Bitly short link. Optionally specify a custom domain (defaults to bit.ly) and a group GUID.",
+      "method": "POST",
+      "path": "/shorten",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "long_url": {
+            "type": "string",
+            "description": "The long URL to shorten."
+          },
+          "domain": {
+            "type": "string",
+            "description": "Custom short domain to use (e.g. 'bit.ly', 'j.mp', or your custom branded domain). Defaults to 'bit.ly'."
+          },
+          "group_guid": {
+            "type": "string",
+            "description": "GUID of the group to associate the short link with. Optional."
+          }
+        },
+        "required": [
+          "long_url"
+        ]
+      }
+    },
+    {
+      "name": "get_bitlink",
+      "description": "Retrieve details about a specific Bitlink including its long URL, creation date, tags, and custom bitlinks. The bitlink parameter should be the short URL without the protocol (e.g. 'bit.ly/abc123').",
+      "method": "GET",
+      "path": "/bitlinks/%7B%7Bparam.bitlink%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bitlink": {
+            "type": "string",
+            "description": "The Bitlink to retrieve, without the protocol. Example: 'bit.ly/abc123'."
+          }
+        },
+        "required": [
+          "bitlink"
+        ]
+      }
+    },
+    {
+      "name": "list_bitlinks",
+      "description": "Retrieve a list of Bitlinks for a specific group. Returns Bitlinks sorted by creation date. Supports pagination and filtering.",
+      "method": "GET",
+      "path": "/groups/%7B%7Bparam.group_guid%7D%7D/bitlinks",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "group_guid": {
+            "type": "string",
+            "description": "The GUID of the group whose Bitlinks to list. Find your group GUID via the Bitly dashboard or by calling the groups endpoint."
+          },
+          "size": {
+            "type": "number",
+            "description": "Number of results per page. Default is 50."
+          },
+          "page": {
+            "type": "number",
+            "description": "Page number for pagination. Default is 1."
+          },
+          "keyword": {
+            "type": "string",
+            "description": "Filter Bitlinks by keyword in the long URL or title. Optional."
+          }
+        },
+        "required": [
+          "group_guid"
+        ]
+      }
+    },
+    {
+      "name": "get_clicks_summary",
+      "description": "Get a summary of clicks for a specific Bitlink. Returns total click count for the specified time period. Useful for analytics and reporting.",
+      "method": "GET",
+      "path": "/bitlinks/%7B%7Bparam.bitlink%7D%7D/clicks/summary",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bitlink": {
+            "type": "string",
+            "description": "The Bitlink to get clicks for, without protocol. Example: 'bit.ly/abc123'."
+          },
+          "unit": {
+            "type": "string",
+            "enum": [
+              "minute",
+              "hour",
+              "day",
+              "week",
+              "month"
+            ],
+            "description": "Time unit for the click data. Defaults to 'day'."
+          },
+          "units": {
+            "type": "number",
+            "description": "Number of time units to query. Use -1 to return all available data. Defaults to -1."
+          },
+          "unit_reference": {
+            "type": "string",
+            "description": "ISO 8601 timestamp for the most recent time to pull metrics. Defaults to current time. Optional."
+          }
+        },
+        "required": [
+          "bitlink"
+        ]
+      }
+    },
+    {
+      "name": "update_bitlink",
+      "description": "Update properties of an existing Bitlink such as its title, tags, or archived status. Note: the destination URL (long_url) cannot be changed after creation.",
+      "method": "PATCH",
+      "path": "/bitlinks/%7B%7Bparam.bitlink%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bitlink": {
+            "type": "string",
+            "description": "The Bitlink to update, without protocol. Example: 'bit.ly/abc123'."
+          },
+          "title": {
+            "type": "string",
+            "description": "New title for the Bitlink."
+          },
+          "archived": {
+            "type": "boolean",
+            "description": "Whether to archive the Bitlink."
+          },
+          "tags": {
+            "type": "array",
+            "description": "Array of tags to associate with the Bitlink.",
+            "items": {
+              "type": "string"
+            }
+          }
+        },
+        "required": [
+          "bitlink"
+        ]
+      }
+    }
+  ]
+}

package/src/apps/bloobirds.json

@@ -0,0 +1,246 @@
+{
+  "slug": "bloobirds",
+  "name": "Bloobirds",
+  "description": "Bloobirds (now Harmonix AI) sales engagement platform. Search and manage companies, leads, and sales pipeline data through the Bobject API.",
+  "logo": "https://www.google.com/s2/favicons?domain=bloobirds.com&sz=128",
+  "categories": [
+    "sales",
+    "crm",
+    "leads",
+    "prospecting",
+    "engagement"
+  ],
+  "base_url": "https://app.bloobirds.com/api",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "token",
+        "label": "Api Key",
+        "description": "Bloobirds API key (generate from Bloobirds admin settings)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "search_companies",
+      "description": "Search for companies in Bloobirds using filters. Returns matching company bobjects with their field values. Supports pagination and field-based filtering.",
+      "method": "POST",
+      "path": "/bobjects/Company/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "object",
+            "description": "Search query filters. Use field names as keys and filter values. Example: {\"COMPANY__NAME\": [\"Acme Corp\"]}."
+          },
+          "page": {
+            "type": "number",
+            "description": "Page number for pagination. Starts at 0. Defaults to 0."
+          },
+          "pageSize": {
+            "type": "number",
+            "description": "Number of results per page. Defaults to 25. Maximum 1000."
+          },
+          "injectReferences": {
+            "type": "boolean",
+            "description": "Whether to resolve referenced bobject fields inline. Defaults to false."
+          },
+          "sort": {
+            "type": "array",
+            "description": "Array of sort objects. Each object has 'field' and 'direction' ('ASC' or 'DESC').",
+            "items": {
+              "type": "object",
+              "properties": {
+                "field": {
+                  "type": "string",
+                  "description": "Field name to sort by."
+                },
+                "direction": {
+                  "type": "string",
+                  "enum": [
+                    "ASC",
+                    "DESC"
+                  ],
+                  "description": "Sort direction."
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "search_leads",
+      "description": "Search for leads in Bloobirds using filters. Returns matching lead bobjects with their field values. Supports pagination and field-based filtering.",
+      "method": "POST",
+      "path": "/bobjects/Lead/search",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "query": {
+            "type": "object",
+            "description": "Search query filters. Use field names as keys and filter values. Example: {\"LEAD__EMAIL\": [\"john@example.com\"]}."
+          },
+          "page": {
+            "type": "number",
+            "description": "Page number for pagination. Starts at 0. Defaults to 0."
+          },
+          "pageSize": {
+            "type": "number",
+            "description": "Number of results per page. Defaults to 25. Maximum 1000."
+          },
+          "injectReferences": {
+            "type": "boolean",
+            "description": "Whether to resolve referenced bobject fields inline. Defaults to false."
+          },
+          "sort": {
+            "type": "array",
+            "description": "Array of sort objects. Each object has 'field' and 'direction' ('ASC' or 'DESC').",
+            "items": {
+              "type": "object",
+              "properties": {
+                "field": {
+                  "type": "string",
+                  "description": "Field name to sort by."
+                },
+                "direction": {
+                  "type": "string",
+                  "enum": [
+                    "ASC",
+                    "DESC"
+                  ],
+                  "description": "Sort direction."
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    {
+      "name": "create_company",
+      "description": "Create a new company bobject in Bloobirds. Provide company field values to create the record in your sales pipeline.",
+      "method": "POST",
+      "path": "/bobjects/Company",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "COMPANY__NAME": {
+            "type": "string",
+            "description": "Name of the company."
+          },
+          "COMPANY__WEBSITE": {
+            "type": "string",
+            "description": "Company website URL."
+          },
+          "COMPANY__INDUSTRY": {
+            "type": "string",
+            "description": "Industry of the company."
+          },
+          "COMPANY__COUNTRY": {
+            "type": "string",
+            "description": "Country where the company is located."
+          },
+          "COMPANY__CITY": {
+            "type": "string",
+            "description": "City where the company is located."
+          },
+          "COMPANY__SIZE": {
+            "type": "string",
+            "description": "Size category of the company (e.g. '1-10', '11-50', '51-200')."
+          }
+        },
+        "required": [
+          "COMPANY__NAME"
+        ]
+      }
+    },
+    {
+      "name": "create_lead",
+      "description": "Create a new lead bobject in Bloobirds. Provide lead field values including the associated company reference to create the record.",
+      "method": "POST",
+      "path": "/bobjects/Lead",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "LEAD__FULL_NAME": {
+            "type": "string",
+            "description": "Full name of the lead."
+          },
+          "LEAD__EMAIL": {
+            "type": "string",
+            "description": "Email address of the lead."
+          },
+          "LEAD__PHONE": {
+            "type": "string",
+            "description": "Phone number of the lead."
+          },
+          "LEAD__JOB_TITLE": {
+            "type": "string",
+            "description": "Job title of the lead."
+          },
+          "LEAD__LINKEDIN_URL": {
+            "type": "string",
+            "description": "LinkedIn profile URL of the lead."
+          },
+          "LEAD__COMPANY": {
+            "type": "string",
+            "description": "Reference ID of the associated company bobject."
+          }
+        },
+        "required": [
+          "LEAD__FULL_NAME",
+          "LEAD__EMAIL"
+        ]
+      }
+    },
+    {
+      "name": "update_lead",
+      "description": "Update an existing lead bobject in Bloobirds. Provide the lead's bobject ID and the fields to update.",
+      "method": "PUT",
+      "path": "/bobjects/Lead/%7B%7Bparam.bobject_id%7D%7D",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "bobject_id": {
+            "type": "string",
+            "description": "The unique bobject ID of the lead to update."
+          },
+          "LEAD__FULL_NAME": {
+            "type": "string",
+            "description": "Updated full name of the lead."
+          },
+          "LEAD__EMAIL": {
+            "type": "string",
+            "description": "Updated email address of the lead."
+          },
+          "LEAD__PHONE": {
+            "type": "string",
+            "description": "Updated phone number of the lead."
+          },
+          "LEAD__JOB_TITLE": {
+            "type": "string",
+            "description": "Updated job title of the lead."
+          },
+          "LEAD__LINKEDIN_URL": {
+            "type": "string",
+            "description": "Updated LinkedIn profile URL."
+          },
+          "LEAD__COMPANY": {
+            "type": "string",
+            "description": "Updated company bobject reference ID."
+          }
+        },
+        "required": [
+          "bobject_id"
+        ]
+      }
+    }
+  ]
+}

package/src/apps/bluesky.json

@@ -0,0 +1,201 @@
+{
+  "slug": "bluesky",
+  "name": "Bluesky",
+  "description": "Bluesky social network integration via the AT Protocol (XRPC). Get profiles, search and create posts, browse feeds, and view follower lists on bsky.social.",
+  "logo": "https://www.google.com/s2/favicons?domain=bsky.social&sz=128",
+  "categories": [
+    "social-media",
+    "bluesky",
+    "atprotocol",
+    "microblogging",
+    "decentralized"
+  ],
+  "base_url": "https://bsky.social",
+  "auth": {
+    "types": [
+      "bearer"
+    ],
+    "headers": {
+      "Authorization": "Bearer {{token}}"
+    },
+    "credential_fields": [
+      {
+        "name": "accessToken",
+        "label": "Access Token",
+        "description": "Bluesky access JWT (obtain via com.atproto.server.createSession)"
+      }
+    ]
+  },
+  "tools": [
+    {
+      "name": "get_profile",
+      "description": "Get the detailed profile of a Bluesky user (actor). Returns display name, bio, avatar, follower/following counts, and post count. Use a handle (e.g. 'alice.bsky.social') or DID.",
+      "method": "GET",
+      "path": "/xrpc/app.bsky.actor.getProfile",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "actor": {
+            "type": "string",
+            "description": "The handle (e.g. 'alice.bsky.social') or DID of the user whose profile to retrieve."
+          }
+        },
+        "required": [
+          "actor"
+        ]
+      }
+    },
+    {
+      "name": "search_posts",
+      "description": "Search for posts matching a query string on Bluesky. Returns post views with text content, author info, timestamps, and engagement metrics. Supports pagination via cursor.",
+      "method": "GET",
+      "path": "/xrpc/app.bsky.feed.searchPosts",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "q": {
+            "type": "string",
+            "description": "The search query string to match against post content."
+          },
+          "limit": {
+            "type": "number",
+            "description": "Maximum number of results to return. Range 1-100. Defaults to 25."
+          },
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from a previous response to fetch the next page."
+          },
+          "sort": {
+            "type": "string",
+            "enum": [
+              "top",
+              "latest"
+            ],
+            "description": "Sort order for results. 'top' for most relevant, 'latest' for most recent. Defaults to 'latest'."
+          }
+        },
+        "required": [
+          "q"
+        ]
+      }
+    },
+    {
+      "name": "create_post",
+      "description": "Create a new post (skeet) on Bluesky. Uses the com.atproto.repo.createRecord XRPC method to write a post record to the user's repository. Provide the text content and your DID as the repo.",
+      "method": "POST",
+      "path": "/xrpc/com.atproto.repo.createRecord",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "repo": {
+            "type": "string",
+            "description": "The DID of the authenticated user (the repository to write to). Example: 'did:plc:abc123'."
+          },
+          "collection": {
+            "type": "string",
+            "description": "The NSID of the record collection. Must be 'app.bsky.feed.post' for creating posts.",
+            "default": "app.bsky.feed.post"
+          },
+          "record": {
+            "type": "object",
+            "description": "The post record object containing the post data.",
+            "properties": {
+              "$type": {
+                "type": "string",
+                "description": "Record type. Must be 'app.bsky.feed.post'.",
+                "default": "app.bsky.feed.post"
+              },
+              "text": {
+                "type": "string",
+                "description": "The text content of the post. Maximum 300 characters."
+              },
+              "createdAt": {
+                "type": "string",
+                "description": "Timestamp in ISO 8601 format. Example: '2025-01-15T12:00:00Z'."
+              },
+              "langs": {
+                "type": "array",
+                "description": "Array of BCP-47 language tags for the post content (e.g. ['en']).",
+                "items": {
+                  "type": "string"
+                }
+              }
+            },
+            "required": [
+              "$type",
+              "text",
+              "createdAt"
+            ]
+          }
+        },
+        "required": [
+          "repo",
+          "collection",
+          "record"
+        ]
+      }
+    },
+    {
+      "name": "get_feed",
+      "description": "Get a user's feed of posts and reposts (their authored content). Returns a chronological list of post views from the specified actor.",
+      "method": "GET",
+      "path": "/xrpc/app.bsky.feed.getAuthorFeed",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "actor": {
+            "type": "string",
+            "description": "The handle (e.g. 'alice.bsky.social') or DID of the user whose feed to retrieve."
+          },
+          "limit": {
+            "type": "number",
+            "description": "Maximum number of posts to return. Range 1-100. Defaults to 50."
+          },
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from a previous response to fetch the next page."
+          },
+          "filter": {
+            "type": "string",
+            "enum": [
+              "posts_with_replies",
+              "posts_no_replies",
+              "posts_with_media",
+              "posts_and_author_threads"
+            ],
+            "description": "Filter the feed by post type. Defaults to 'posts_with_replies'."
+          }
+        },
+        "required": [
+          "actor"
+        ]
+      }
+    },
+    {
+      "name": "get_followers",
+      "description": "Get the list of accounts that follow a specified Bluesky user. Returns follower profiles with display names, handles, and bios. Supports pagination.",
+      "method": "GET",
+      "path": "/xrpc/app.bsky.graph.getFollowers",
+      "input_schema": {
+        "type": "object",
+        "properties": {
+          "actor": {
+            "type": "string",
+            "description": "The handle (e.g. 'alice.bsky.social') or DID of the user whose followers to list."
+          },
+          "limit": {
+            "type": "number",
+            "description": "Maximum number of followers to return. Range 1-100. Defaults to 50."
+          },
+          "cursor": {
+            "type": "string",
+            "description": "Pagination cursor from a previous response to fetch the next page."
+          }
+        },
+        "required": [
+          "actor"
+        ]
+      }
+    }
+  ]
+}