@thierryteisseire/leadgenius-skill 1.1.1 → 1.1.2

package/SKILL.md

@@ -65,6 +65,9 @@ python3 scripts/lgp.py auth --email your@email.com
 # List leads
 python3 scripts/lgp.py leads list
 
+# Find specific leads
+python3 scripts/lgp.py leads find --full-name "Hugo Sanchez"
+
 # Enrich specific leads
 python3 scripts/lgp.py leads enrich --ids lead_1 lead_2
 ```

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@thierryteisseire/leadgenius-skill",
-    "version": "1.1.1",
+    "version": "1.1.2",
     "description": "LeadGenius Pro Agent API Skill for AI agents",
     "main": "SKILL.md",
     "repository": {

package/references/api_reference.md

@@ -3,7 +3,7 @@
 This document provides a detailed breakdown of all available endpoints in the LeadGenius Pro Agent API.
 
 ## Base URL
-`https://last.leadgenius.app/api/agent`
+`https://your-domain.com/api/agent`
 
 ## Authentication
 All requests require an API key passed in headers:
@@ -41,7 +41,7 @@ Lifecycle management for marketing and sales leads.
 
 ### `GET /leads`
 List leads with advanced filtering.
-- **Filters**: `status`, `campaignId`, `email`, `companyName`.
+- **Filters**: `status`, `campaignId`, `email`, `companyName`, `firstName`, `lastName`, `fullName`.
 - **Pagination**: `page`, `pageSize` (Default 20, Max 100).
 
 ### `POST /leads`
@@ -120,50 +120,3 @@ Manage connections to CRMs (Salesforce, HubSpot) and Mail Platforms.
 
 ### `GET /webhooks`
 Configure event-based real-time notifications.
-
----
-
-## 🛠️ Maintenance & System Health
-Endpoints for reporting issues and providing feedback.
-
-### `GET /maintenance/bugs`
-List reported bugs.
-
-### `POST /maintenance/bugs`
-Report a discovered issue.
-- **Body**: `{ description, userEmail }`
-
-### `GET /maintenance/enhancements`
-List requested enhancements.
-
-### `POST /maintenance/enhancements`
-Request a new feature.
-- **Body**: `{ description, userEmail }`
-
----
-
-## 👑 Global Administration (Admin Only)
-High-level system management. Requires Master Admin status.
-Root Path: `/api/admin`
-
-### `GET /companies`
-List all organizations currently using the platform.
-
-### `GET /users`
-Get the global directory of all platform users and their roles.
-
----
-
-## 🔑 Authentication & API Keys
-### `POST /epsimo-auth`
-Exchange email/password for a JWT token.
-- **Root Path**: `/api/epsimo-auth`
-- **Body**: `{ email, password }`
-
-### `POST /agent-api-keys`
-Generate a new persistent API Key.
-- **Auth**: Requires JWT (Bearer)
-- **Body**: `{ name, description }`
-
-### `GET /agent-api-keys`
-List active API keys for the current user.

package/scripts/api_call.py

@@ -10,7 +10,7 @@ def main():
     parser.add_argument("method", choices=["GET", "POST", "PUT", "DELETE"], help="HTTP method")
     parser.add_argument("endpoint", help="API endpoint (e.g., /leads)")
     parser.add_argument("--data", help="JSON data for POST/PUT requests")
-    parser.add_argument("--base-url", default="https://last.leadgenius.app/api/agent", help="Base URL")
+    parser.add_argument("--base-url", default="http://localhost:3000/api/agent", help="Base URL")
     parser.add_argument("--key", help="API Key (defaults to LGP_API_KEY env var)")
 
     args = parser.parse_args()
@@ -37,26 +37,8 @@ def main():
         print("Error: API Key is required. Run 'python3 scripts/auth.py' first, use --key, or set LGP_API_KEY.")
         sys.exit(1)
 
-    # Detect base path
-    root_base = args.base_url.rstrip('/').replace('/api/agent', '')
-    
-    if args.endpoint.startswith('/admin') or args.endpoint.startswith('admin/'):
-         # Admin routes
-         base_url = f"{root_base}/api/admin"
-         clean_endpoint = args.endpoint.replace('/admin/', '').replace('admin/', '').lstrip('/')
-    elif 'epsimo-auth' in args.endpoint or 'agent-api-keys' in args.endpoint:
-         # Root API routes
-         base_url = f"{root_base}/api"
-         clean_endpoint = args.endpoint.lstrip('/')
-    else:
-         # Default Agent routes
-         base_url = f"{root_base}/api/agent"
-         clean_endpoint = args.endpoint.lstrip('/')
-
-    url = f"{base_url}/{clean_endpoint}"
-    
+    url = f"{args.base_url.rstrip('/')}/{args.endpoint.lstrip('/')}"
     headers = {
-        "Authorization": f"Bearer {api_key}",
         "X-API-Key": api_key,
         "Content-Type": "application/json"
     }
@@ -66,7 +48,6 @@ def main():
         if args.data:
             data = json.loads(args.data)
 
-        print(f"Calling: {args.method} {url}")
         response = requests.request(args.method, url, headers=headers, json=data)
         
         print(f"Status: {response.status_code}")

package/scripts/auth.py

@@ -6,7 +6,7 @@ import requests
 import sys
 from getpass import getpass
 
-DEFAULT_BASE_URL = "https://last.leadgenius.app"
+DEFAULT_BASE_URL = "http://localhost:3000"
 AUTH_FILE = os.path.expanduser("~/.leadgenius_auth.json")
 
 def main():

package/scripts/lgp.py

@@ -5,9 +5,9 @@ import os
 import requests
 import sys
 from getpass import getpass
-from datetime import datetime, timedelta
+from datetime import datetime
 
-DEFAULT_BASE_URL = "https://last.leadgenius.app"
+DEFAULT_BASE_URL = "http://localhost:3000"
 AUTH_FILE = os.path.expanduser("~/.leadgenius_auth.json")
 
 class LeadGeniusCLI:
@@ -32,16 +32,13 @@ class LeadGeniusCLI:
                 pass
         return None
 
-    def _request(self, method, endpoint, data=None, params=None, is_admin=False):
+    def _request(self, method, endpoint, data=None, params=None):
         if not self.token:
             print("Error: Not authenticated. Set LGP_API_KEY or run 'lgp auth'.")
             sys.exit(1)
 
-        base_path = "/api/admin" if is_admin else "/api/agent"
-        url = f"{self.base_url}/{base_path.strip('/')}/{endpoint.lstrip('/')}"
-        
+        url = f"{self.base_url}/api/agent/{endpoint.lstrip('/')}"
         headers = {
-            "Authorization": f"Bearer {self.token}",
             "X-API-Key": self.token,
             "Content-Type": "application/json"
         }
@@ -63,11 +60,7 @@ class LeadGeniusCLI:
                 print("Make sure LGP_API_KEY is set to a valid API Key.")
                 return None
             if response.status_code >= 400:
-                # Silently return so the caller can decide what to print or just print error
-                if response.status_code == 403:
-                    print(f"Error (403): Master Admin access required for {url}")
-                else:
-                    print(f"Error ({response.status_code}): {response.text}")
+                print(f"Error ({response.status_code}): {response.text}")
                 return None
             return response.json()
         except Exception as e:
@@ -161,6 +154,54 @@ class LeadGeniusCLI:
         if data:
             print(json.dumps(data, indent=2))
 
+    def find_lead(self, first_name=None, last_name=None, full_name=None, email=None, company=None):
+        params = {"pageSize": 100}
+        if first_name:
+            params["firstName"] = first_name
+        if last_name:
+            params["lastName"] = last_name
+        if full_name:
+            params["fullName"] = full_name
+        if email:
+            params["email"] = email
+        if company:
+            params["companyName"] = company
+        data = self._request("GET", "leads", params=params)
+        if data:
+            leads = data.get("data", [])
+            if not leads:
+                print("No leads found matching criteria.")
+                return
+
+            # Client-side filtering (polyfill for server limitation)
+            filtered_leads = []
+            for lead in leads:
+                match = True
+                if first_name and first_name.lower() not in (lead.get('firstName') or '').lower(): match = False
+                if last_name and last_name.lower() not in (lead.get('lastName') or '').lower(): match = False
+                if full_name and full_name.lower() not in (lead.get('fullName') or '').lower(): match = False
+                if email and email.lower() not in (lead.get('email') or '').lower(): match = False
+                if company and company.lower() not in (lead.get('companyName') or '').lower(): match = False
+                
+                if match:
+                    filtered_leads.append(lead)
+
+            if not filtered_leads:
+                print("No leads found matching criteria (checked 100 most recent).")
+                return
+
+            print(f"Found {len(filtered_leads)} lead(s):\n")
+            for lead in filtered_leads:
+                print(f"  ID:       {lead.get('id')}")
+                print(f"  Name:     {lead.get('fullName') or lead.get('contactName', 'N/A')}")
+                print(f"  Title:    {lead.get('title', 'N/A')}")
+                print(f"  Company:  {lead.get('companyName', 'N/A')}")
+                print(f"  Email:    {lead.get('email', 'N/A')}")
+                print(f"  LinkedIn: {lead.get('linkedinUrl', 'N/A')}")
+                print(f"  Location: {lead.get('city', 'N/A')}, {lead.get('country', 'N/A')}")
+                print(f"  Status:   {lead.get('status', 'N/A')}")
+                print()
+
     def enrich_leads(self, lead_ids, type="technographic"):
         payload = {"leadIds": lead_ids, "enrichmentType": type}
         data = self._request("POST", "enrichment/trigger", data=payload)
@@ -171,12 +212,7 @@ class LeadGeniusCLI:
     def list_campaigns(self):
         data = self._request("GET", "campaigns")
         if data:
-            # Production uses "data" field for lists
-            campaigns = data.get("data")
-            if campaigns is None: # Fallback for local/legacy if applicable
-                campaigns = data.get("campaigns", [])
-            
-            for c in campaigns:
+            for c in data.get("campaigns", []):
                 print(f"[{c.get('id')}] {c.get('name')} ({c.get('status')})")
 
     def create_campaign(self, name, type="abm"):
@@ -186,7 +222,7 @@ class LeadGeniusCLI:
             print(f"Campaign created: {data.get('id')}")
 
     # Analytics
-    def show_pipeline(self, start_date, end_date):
+    def show_pipeline(self, start_date=None, end_date=None):
         params = {"startDate": start_date, "endDate": end_date}
         data = self._request("GET", "analytics/pipeline", params=params)
         if data:
@@ -220,17 +256,36 @@ class LeadGeniusCLI:
              enh = data.get('enhancement', {})
              print(f"Enhancement requested: ID {enh.get('id')}")
     
-    # Admin (Master Admin Only)
+    # Admin
     def list_all_companies(self):
-        data = self._request("GET", "companies", is_admin=True)
-        if data:
-            print(json.dumps(data, indent=2))
+         # Admin endpoint call attempt
+        print("Warning: Admin endpoints require session cookies. This might fail with API Key.")
+        url = f"{self.base_url}/api/admin/companies"
+        headers = {
+            "Content-Type": "application/json",
+             # Try passing API Key anyway, maybe backend changes later
+            "X-API-Key": self.token
+        }
+        try:
+             response = requests.get(url, headers=headers)
+             print(f"Status: {response.status_code}")
+             print(response.text)
+        except Exception as e:
+            print(f"Error: {e}")
 
     def list_all_users(self):
-        data = self._request("GET", "users", is_admin=True)
-        if data:
-            print(json.dumps(data, indent=2))
-
+        print("Warning: Admin endpoints require session cookies. This might fail with API Key.")
+        url = f"{self.base_url}/api/admin/users"
+        headers = {
+            "Content-Type": "application/json",
+            "X-API-Key": self.token
+        }
+        try:
+             response = requests.get(url, headers=headers)
+             print(f"Status: {response.status_code}")
+             print(response.text)
+        except Exception as e:
+            print(f"Error: {e}")
 
 def main():
     parser = argparse.ArgumentParser(description="LeadGenius Pro Agent CLI")
@@ -248,8 +303,13 @@ def main():
 
     # Leads
     leads_parser = subparsers.add_parser("leads", help="Manage leads")
-    leads_parser.add_argument("action", choices=["list", "enrich"])
+    leads_parser.add_argument("action", choices=["list", "find", "enrich"])
     leads_parser.add_argument("--ids", nargs="+", help="Lead IDs for enrichment")
+    leads_parser.add_argument("--first-name", help="First name filter (for find)")
+    leads_parser.add_argument("--last-name", help="Last name filter (for find)")
+    leads_parser.add_argument("--full-name", help="Full name search (for find)")
+    leads_parser.add_argument("--email", help="Email filter (for find)")
+    leads_parser.add_argument("--company", help="Company name filter (for find)")
 
     # Campaigns
     camp_parser = subparsers.add_parser("campaigns", help="Manage campaigns")
@@ -291,6 +351,17 @@ def main():
     elif args.command == "leads":
         if args.action == "list":
             cli.list_leads()
+        elif args.action == "find":
+            if not any([args.first_name, args.last_name, args.full_name, args.email, args.company]):
+                print("Error: provide at least one filter: --first-name, --last-name, --full-name, --email, or --company")
+                return
+            cli.find_lead(
+                first_name=args.first_name,
+                last_name=args.last_name,
+                full_name=args.full_name,
+                email=args.email,
+                company=args.company,
+            )
         elif args.action == "enrich":
             if not args.ids:
                 print("Error: --ids required for enrichment")