qodev-apollo-cli 1.3.0__tar.gz → 1.4.0__tar.gz

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/CHANGELOG.md

@@ -6,6 +6,22 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [1.4.0] - 2026-07-10
+
+### Fixed
+
+- `deals search --query` now searches the **deal name** (`q_opportunity_name`). Apollo silently ignores `q_keywords` on `/opportunities/search`, so name search never actually filtered before.
+- `jobs list` renders the organization job-postings shape (`Title/City/State/URL/Posted`) returned by the fixed API.
+
+### Changed
+
+- Require `qodev-apollo-api>=0.5.0` (people `api_search`, deal name param, repaired `list_*` endpoints, search-filter validation).
+- **Skill** (`SKILL.md` + references): added a "Search filter formats" section (seniority enums, location formats, `"min,max"` employee ranges, dict ranges, deal name search, canonical `linkedin_url`); documented `deals create` and `people --keywords`.
+
+### Removed
+
+- **Breaking:** `news list` and `calls list` commands — the underlying Apollo routes were removed (`list_account_news` / `list_contact_calls` are gone from the API). `calls search` remains.
+
 ## [1.3.0] - 2026-07-09
 
 ### Added

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: qodev-apollo-cli
-Version: 1.3.0
+Version: 1.4.0
 Summary: Agent-friendly CLI for the Apollo API
 Project-URL: Homepage, https://github.com/qodevai/apollo-cli
 Project-URL: Repository, https://github.com/qodevai/apollo-cli
@@ -19,7 +19,7 @@ Classifier: Programming Language :: Python :: 3.13
 Classifier: Typing :: Typed
 Requires-Python: >=3.11
 Requires-Dist: cyclopts>=3.0
-Requires-Dist: qodev-apollo-api>=0.4.0
+Requires-Dist: qodev-apollo-api>=0.5.0
 Requires-Dist: rich>=13.0
 Provides-Extra: dev
 Requires-Dist: mypy>=1.13.0; extra == 'dev'

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "qodev-apollo-cli"
-version = "1.3.0"
+version = "1.4.0"
 description = "Agent-friendly CLI for the Apollo API"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -20,7 +20,7 @@ classifiers = [
 dependencies = [
     "cyclopts>=3.0",
     "rich>=13.0",
-    "qodev-apollo-api>=0.4.0",
+    "qodev-apollo-api>=0.5.0",
 ]
 
 [project.optional-dependencies]

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/src/apollo_cli/app.py

@@ -33,7 +33,6 @@ from apollo_cli.commands.emails import emails_app  # noqa: E402
 from apollo_cli.commands.enrich import enrich_app  # noqa: E402
 from apollo_cli.commands.install import install_app  # noqa: E402
 from apollo_cli.commands.jobs import jobs_app  # noqa: E402
-from apollo_cli.commands.news import news_app  # noqa: E402
 from apollo_cli.commands.notes import notes_app  # noqa: E402
 from apollo_cli.commands.people import people_app  # noqa: E402
 from apollo_cli.commands.pipelines import pipelines_app, stages_app  # noqa: E402
@@ -55,7 +54,6 @@ _sub_apps = [
     conversations_app,
     custom_fields_app,
     emails_app,
-    news_app,
     jobs_app,
     usage_app,
     install_app,

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/src/apollo_cli/commands/calls.py

@@ -2,13 +2,11 @@
 
 from __future__ import annotations
 
-from typing import Annotated
-
-from cyclopts import App, Parameter
+from cyclopts import App
 
 from apollo_cli.context import ctx
 from apollo_cli.formatters.generic import list_table
-from apollo_cli.output import output_json, output_list, output_markdown
+from apollo_cli.output import output_list
 
 calls_app = App(name="calls", help="Call activity.")
 
@@ -37,18 +35,3 @@ async def search() -> None:
         format_fn=lambda items, **kw: list_table(items, CALL_LIST_COLUMNS, title="Calls", **kw),
         resource_name="Calls",
     )
-
-
-@calls_app.command(name="list")
-async def list_contact_calls(
-    contact_id: Annotated[str, Parameter(help="Contact ID")],
-) -> None:
-    """List calls for a specific contact."""
-    async with ctx.client() as client:
-        result = await client.list_contact_calls(contact_id)
-
-    if ctx.json_mode:
-        output_json(result)
-    else:
-        md = list_table(result, CALL_LIST_COLUMNS, title="Contact Calls", total=len(result), page=1)
-        output_markdown(md)

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/src/apollo_cli/commands/deals.py

@@ -19,7 +19,7 @@ deals_app = App(name="deals", help="Manage deals/opportunities.")
 @deals_app.command
 async def search(
     *,
-    query: Annotated[str, Parameter(name=["--query", "-q"], help="Search keyword")] = "",
+    query: Annotated[str, Parameter(name=["--query", "-q"], help="Search by deal name")] = "",
     stage_id: Annotated[str | None, Parameter(name="--stage-id", help="Filter by deal stage ID")] = None,
     stage_name: Annotated[
         str | None,
@@ -28,10 +28,12 @@ async def search(
         ),
     ] = None,
 ) -> None:
-    """Search deals by keyword or filter."""
+    """Search deals by name or filter."""
     filters: dict = {}
     if query:
-        filters["q_keywords"] = query
+        # Deal name search is q_opportunity_name — Apollo silently ignores
+        # q_keywords on /opportunities/search (it returns every deal).
+        filters["q_opportunity_name"] = query
     stage_ids: list[str] = []
     if stage_id:
         stage_ids.append(stage_id)

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/src/apollo_cli/commands/jobs.py

@@ -14,8 +14,8 @@ jobs_app = App(name="jobs", help="Job postings.")
 
 JOBS_LIST_COLUMNS = [
     ("Title", "title"),
-    ("Location", "location"),
-    ("Department", "department"),
+    ("City", "city"),
+    ("State", "state"),
     ("URL", "url"),
     ("Posted", "posted_at"),
 ]

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/src/apollo_cli/skills/SKILL.md

@@ -47,8 +47,9 @@ Get your API key from [Apollo.io Settings → API](https://app.apollo.io/#/setti
 
 | Command | Description |
 |---------|-------------|
-| `deals search [--query Q] [--stage-id ID] [--stage-name NAME]` | Search opportunities/deals |
+| `deals search [--query Q] [--stage-id ID] [--stage-name NAME]` | Search deals. `--query` matches the **deal name** (`q_opportunity_name`) |
 | `deals get ID` | Get deal details |
+| `deals create --name N [--owner-id ID] [--account-id ID] [--amount N] [--stage-id ID \| --stage-name NAME] [--closed-date YYYY-MM-DD]` | Create a deal (needs a master API key) |
 | `deals role-types` | List opportunity contact role types |
 | `deals set-role ID --contact-id C [--role-type NAME_OR_ID] [--primary]` | Set/update a contact's role on a deal |
 
@@ -78,7 +79,7 @@ Get your API key from [Apollo.io Settings → API](https://app.apollo.io/#/setti
 
 | Command | Description |
 |---------|-------------|
-| `people search [--titles T] [--seniorities S] [--locations L] [--organization-domains D]` | Search people database (respects `--limit`/`--page`) |
+| `people search [--keywords K] [--titles T] [--seniorities S] [--locations L] [--organization-domains D]` | Search people database (respects `--limit`/`--page`). Returns teaser data only — no email/linkedin without enrichment. See **Search filter formats** below |
 
 ### notes
 
@@ -122,17 +123,11 @@ Recorded meetings (Zoom/Teams/Meet) with transcript and AI summary — distinct
 |---------|-------------|
 | `emails search` | Search email activities |
 
-### news
-
-| Command | Description |
-|---------|-------------|
-| `news search [--categories CATS]` | Search news |
-
 ### jobs
 
 | Command | Description |
 |---------|-------------|
-| `jobs search [--job-titles TITLES] [--company-domains DOMAINS]` | Search job postings |
+| `jobs list ACCOUNT_ID` | List job postings for an account's linked organization |
 
 ### usage
 
@@ -140,6 +135,32 @@ Recorded meetings (Zoom/Teams/Meet) with transcript and AI summary — distinct
 |---------|-------------|
 | `usage` | Show API usage stats and rate limits |
 
+## Search filter formats
+
+Apollo **silently ignores** a filter whose value is in the wrong format (it returns an
+unfiltered/whole page that looks like a real match) — so getting the format right matters.
+These are empirically verified (each measurably narrows the result count):
+
+**`people search`**
+| Filter | Format | Notes |
+|--------|--------|-------|
+| `--keywords` | free text | names / titles / keywords |
+| `--titles` | comma list of titles | e.g. `--titles "CEO,VP Sales"` |
+| `--seniorities` | **lowercase enums** | `owner, founder, c_suite, partner, vp, head, director, manager, senior, entry, intern`. `"VP"` / `"vice president"` match **nothing** |
+| `--locations` | country name, **2-letter code** (`US`), or `"City, State, Country"` | `US` ≡ `United States` |
+| `--organization-domains` | comma list of domains | e.g. `acme.com,globex.com` |
+
+Raw API (via `qodev_apollo_api`) also accepts, on people search:
+`organization_num_employees_ranges` as **`"min,max"` comma** strings (`["1,10"]`, `["1000,5000"]` — a dash `"1-10"` is silently ignored); `revenue_range`/`organization_num_jobs_range` as `{"min":N,"max":N}`; `contact_email_status` as `verified|unverified|likely to engage|unavailable`; `currently_using_any_of_technology_uids` as a list of tech UIDs.
+
+**`deals search`** — `--query` searches the **deal name** (`q_opportunity_name`). *(Plain keyword search is not supported by Apollo for deals.)*
+
+**`contacts search`** — `--linkedin-url` must be a real LinkedIn profile URL; the CLI canonicalizes it to Apollo's stored form (`http://www.linkedin.com/in/<slug>`). `--query` is free-text keywords.
+
+**`accounts search`** — `--query` is a company-name keyword (`q_organization_name`).
+
+**Stage filters** (`--stage-id`/`--stage-name` on contacts/deals) take a stage the account actually has — list them with `contacts stages` / `pipelines stages`.
+
 ## Exit Codes
 
 | Code | Meaning |

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/src/apollo_cli/skills/references/deal-workflows.md

@@ -36,7 +36,7 @@ qodev-apollo-cli --json pipelines stages <pipeline-id> | jq '.items[] | {name, i
 # Search all deals
 qodev-apollo-cli deals search
 
-# Search by keyword
+# Search by deal name (--query matches the deal name, not free keywords)
 qodev-apollo-cli deals search --query "enterprise"
 
 # Filter by stage

{qodev_apollo_cli-1.3.0 → qodev_apollo_cli-1.4.0}/uv.lock

@@ -472,7 +472,7 @@ wheels = [
 
 [[package]]
 name = "qodev-apollo-api"
-version = "0.4.0"
+version = "0.5.0"
 source = { directory = "../apollo-api" }
 dependencies = [
     { name = "httpx" },
@@ -494,7 +494,7 @@ provides-extras = ["dev"]
 
 [[package]]
 name = "qodev-apollo-cli"
-version = "1.2.1"
+version = "1.4.0"
 source = { editable = "." }
 dependencies = [
     { name = "cyclopts" },

qodev_apollo_cli-1.3.0/src/apollo_cli/commands/news.py

@@ -1,35 +0,0 @@
-"""News command group."""
-
-from __future__ import annotations
-
-from typing import Annotated
-
-from cyclopts import App, Parameter
-
-from apollo_cli.context import ctx
-from apollo_cli.formatters.generic import list_table
-from apollo_cli.output import output_json, output_markdown
-
-news_app = App(name="news", help="Account news.")
-
-NEWS_LIST_COLUMNS = [
-    ("Title", "title"),
-    ("Category", "category"),
-    ("Published", "published_at"),
-    ("URL", "url"),
-]
-
-
-@news_app.command(name="list")
-async def list_news(
-    account_id: Annotated[str, Parameter(help="Account ID")],
-) -> None:
-    """List news articles for an account."""
-    async with ctx.client() as client:
-        result = await client.list_account_news(account_id)
-
-    if ctx.json_mode:
-        output_json(result)
-    else:
-        md = list_table(result, NEWS_LIST_COLUMNS, title="Account News", total=len(result), page=1)
-        output_markdown(md)