trackly-cli 0.2.8 → 0.3.2

package/README.md

@@ -35,7 +35,7 @@ trackly jobs --function product
 
 ## At a Glance
 
-1,900+ companies | 128K+ jobs | 40+ ATS types | CLI + MCP | 10 MCP tools
+1,900+ companies | 128K+ jobs | 40+ ATS types | CLI + MCP | 11 MCP tools
 
 ## CLI Commands
 
@@ -63,6 +63,7 @@ trackly referral start 1234           # Start a referral campaign
 trackly referral status 1234          # Check referral campaign status
 trackly company-brief 243             # Get company brief (--refresh to regenerate)
 trackly company-workspace 243         # Full company workspace view
+trackly request-company "eBay"        # Request a company be added (--url, --notes optional)
 trackly api-key create                # Generate API key
 trackly api-key list                  # List API keys
 trackly config                        # Show current CLI config

package/bin/trackly

@@ -28,11 +28,13 @@ const VALUE_FLAGS = new Set([
   'keywords',
   'limit',
   'name',
+  'notes',
   'offset',
   'region',
   'search',
   'sort',
   'status',
+  'url',
 ]);
 const AUTH_HELP_TEXT = `Not authenticated.
   Option 1: trackly login                        (Google OAuth)
@@ -668,6 +670,43 @@ async function cmdCompanyWorkspace(args) {
   }
 }
 
+async function cmdRequestCompany(args) {
+  // Positional arg = company name. Allow multi-word names without forcing the user
+  // to quote, e.g. `trackly request-company Built Robotics --url ...` joins the
+  // free-floating positionals into "Built Robotics". Matches `trackly ask` UX.
+  const name = (args._ || []).join(' ').trim();
+  if (!name) {
+    failNow('Company name required. Usage: trackly request-company <name> [--url <url>] [--notes <notes>]');
+  }
+  if (!hasAuth()) failNow(AUTH_HELP_TEXT);
+
+  const url = typeof args.url === 'string' ? args.url : '';
+  const notes = typeof args.notes === 'string' ? args.notes : '';
+
+  try {
+    const result = await apiRequest('POST', '/api/jobscout/companies/request', {
+      company_name: name,
+      company_url: url,
+      notes: notes,
+      source: 'cli',
+    });
+    if (isJSON()) return printJson(result);
+    const requestId = result.requestId || result.id || '?';
+    console.log(color('green', `Requested "${name}" (#${requestId}). Trackly team will review shortly.`));
+  } catch (e) {
+    // Backend returns 429 (rate limit, max 5 pending) and 409 (duplicate pending request)
+    // with a specific `error` message. Surface that message verbatim so the user knows
+    // exactly which gate fired without having to enable --json.
+    if (e.status === 429) {
+      setErrorExit(e.error || 'Maximum 5 pending requests allowed. Please wait for existing requests to be reviewed.');
+    } else if (e.status === 409) {
+      setErrorExit(e.error || 'You already have a pending request for this company.');
+    } else {
+      setErrorExit(e.error || e.message || 'Failed to request company');
+    }
+  }
+}
+
 async function cmdConfig(args) {
   if (args['api-key'] === null) failNow('API key value required. Usage: trackly config --api-key <key>');
   if (args['base-url'] === null) failNow('Base URL value required. Usage: trackly config --base-url <url>');
@@ -770,6 +809,7 @@ ${color('bold', 'Commands:')}
   ${color('cyan', 'brief <id>')}           Get network brief for a job
   ${color('cyan', 'company-brief <id>')}   Get company brief (--refresh to generate)
   ${color('cyan', 'company-workspace <id>')} Show company workspace (jobs, contacts, campaigns)
+  ${color('cyan', 'request-company <name>')} Request a company be added to Trackly (--url, --notes)
   ${color('cyan', 'api-key create')}       Generate an API key
   ${color('cyan', 'api-key list')}         List your API keys
   ${color('cyan', 'config')}               Show or update CLI config (--api-key, --base-url)
@@ -926,6 +966,9 @@ async function main() {
     case 'company-workspace':
       await cmdCompanyWorkspace(args);
       break;
+    case 'request-company':
+      await cmdRequestCompany(args);
+      break;
     case 'api-key':
       await cmdApiKey(args);
       break;

package/mcp/server.js

@@ -297,6 +297,24 @@ function createServer() {
     }, 'Failed to fetch company workspace')
   );
 
+  server.tool(
+    'trackly_request_company',
+    'Request that a company be added to Trackly\'s tracked companies. Use when the user asks about a company that isn\'t in trackly_search_companies / trackly_list_companies results. Rate-limited to 5 pending requests per user.',
+    {
+      companyName: z.string().min(1).max(200).describe('Company name (e.g. "eBay")'),
+      companyUrl: z.string().max(500).optional().describe('Optional careers page or homepage URL (e.g. "https://careers.ebay.com")'),
+      notes: z.string().max(1000).optional().describe('Optional context (e.g. "MBA hiring page", "specific role I want tracked")'),
+    },
+    wrapTool(async ({ companyName, companyUrl, notes }) => {
+      return apiRequest('POST', '/api/jobscout/companies/request', {
+        company_name: companyName,
+        company_url: companyUrl || '',
+        notes: notes || '',
+        source: 'mcp',
+      }, false, false, MCP_USER_AGENT);
+    }, 'Failed to request company')
+  );
+
   return server;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackly-cli",
-  "version": "0.2.8",
+  "version": "0.3.2",
   "mcpName": "io.github.trackly-app/trackly",
   "description": "AI job search CLI + hosted MCP server with OAuth. 128K+ jobs, 1,900+ companies, 40+ ATS. Works with Claude, ChatGPT, Cursor, Windsurf, Codex via hosted streamable-http or local stdio.",
   "bin": {

package/server.json

@@ -17,12 +17,12 @@
       ]
     }
   ],
-  "version": "0.2.8",
+  "version": "0.3.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "trackly-cli",
-      "version": "0.2.8",
+      "version": "0.3.2",
       "runtimeHint": "npx",
       "runtimeArguments": [
         {