autotouch-cli 0.2.34__tar.gz → 0.2.35__tar.gz

{autotouch_cli-0.2.34 → autotouch_cli-0.2.35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.34
+Version: 0.2.35
 Summary: Autotouch Smart Table CLI
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown

{autotouch_cli-0.2.34 → autotouch_cli-0.2.35}/autotouch_cli/cli.py

@@ -38,6 +38,10 @@ from autotouch_shared.linkedin_contract import (
     linkedin_recipe_entries,
     linkedin_recipe_types,
 )
+from autotouch_shared.search_contract import (
+    search_recipe_entries,
+    search_recipe_types,
+)
 from autotouch_shared.provider_registry import (
     automation_workflow_blueprints,
     get_recipe_contract,
@@ -93,6 +97,8 @@ SETUP_BANNER = r"""
 
 COLUMN_RECIPE_TYPES = recipe_types()
 WORKFLOW_BLUEPRINT_TYPES = tuple(sorted(automation_workflow_blueprints().keys()))
+SEARCH_RECIPE_TYPES = list(search_recipe_types())
+SEARCH_RECIPES: Dict[str, Any] = search_recipe_entries()
 
 
 def _build_column_recipe_catalog() -> Tuple[Dict[str, Dict[str, Any]], Dict[str, List[str]]]:
@@ -3585,6 +3591,7 @@ def cmd_capabilities(args: argparse.Namespace) -> None:
             print("--------------")
             print(", ".join(sorted(str(name) for name in providers.keys())))
         linkedin = data.get("linkedin") if isinstance(data.get("linkedin"), dict) else None
+        search = data.get("search") if isinstance(data.get("search"), dict) else None
         if isinstance(linkedin, dict):
             print("")
             print("LinkedIn list building")
@@ -3596,7 +3603,44 @@ def cmd_capabilities(args: argparse.Namespace) -> None:
             if caps:
                 for mode, cap in caps.items():
                     print(f"  {mode:20s}: {cap}")
+            best_for = linkedin.get("best_for")
+            if isinstance(best_for, list) and best_for:
+                print("Best for        :")
+                for item in best_for:
+                    print(f"  - {item}")
+            not_for = linkedin.get("not_for")
+            if isinstance(not_for, list) and not_for:
+                print("Not for         :")
+                for item in not_for:
+                    print(f"  - {item}")
             print("Tip: run `autotouch linkedin recipe` for example payloads.")
+        if isinstance(search, dict):
+            print("")
+            print("Provider-hidden search")
+            print("----------------------")
+            pricing = search.get("pricing", {}).get("families", {})
+            if isinstance(pricing, dict) and pricing:
+                print("Pricing")
+                for family, entry in pricing.items():
+                    if isinstance(entry, dict):
+                        print(f"  {family:20s}: {entry.get('rule', '-')}")
+            chooser = search.get("chooser_guidance") if isinstance(search.get("chooser_guidance"), dict) else {}
+            company_first = chooser.get("use_company_search_when")
+            if isinstance(company_first, list) and company_first:
+                print("Use company search when:")
+                for item in company_first:
+                    print(f"  - {item}")
+            people_first = chooser.get("use_people_search_when")
+            if isinstance(people_first, list) and people_first:
+                print("Use people search when:")
+                for item in people_first:
+                    print(f"  - {item}")
+            linkedin_instead = chooser.get("use_linkedin_instead_when")
+            if isinstance(linkedin_instead, list) and linkedin_instead:
+                print("Use LinkedIn instead when:")
+                for item in linkedin_instead:
+                    print(f"  - {item}")
+            print("Tip: run `autotouch search recipe` for example payloads.")
         print("")
         print("Tip: inspect automation.providers in JSON output for provider-specific setup contracts.")
         print("Tip: for JSON enrichment columns, run with `--wait` and verify terminal status before `autotouch columns projections`.")
@@ -6494,6 +6538,224 @@ def _add_leads_selection_arguments(parser: argparse.ArgumentParser) -> None:
     )
 
 
+# ---------------------------------------------------------------------------
+# Search commands
+# ---------------------------------------------------------------------------
+
+
+def cmd_search_recipe(args: argparse.Namespace) -> None:
+    selected = str(args.type or "all")
+    if selected == "all":
+        output = {"recipes": SEARCH_RECIPES}
+        if args.out_file:
+            with open(args.out_file, "w", encoding="utf-8") as f:
+                json.dump(output, f, indent=2)
+        _print_json(output, compact=args.compact)
+        return
+
+    recipe = SEARCH_RECIPES.get(selected)
+    if not recipe:
+        print(f"ERROR: unknown recipe type '{selected}'", file=sys.stderr)
+        sys.exit(2)
+    output = {"type": selected, **recipe}
+    if args.out_file and recipe.get("payload") is not None:
+        with open(args.out_file, "w", encoding="utf-8") as f:
+            json.dump(recipe["payload"], f, indent=2)
+    _print_json(output, compact=args.compact)
+
+
+def _load_search_payload(args: argparse.Namespace, *, default_payload: Dict[str, Any]) -> Dict[str, Any]:
+    explicit = _load_json_input(
+        inline_json=getattr(args, "data_json", None),
+        file_path=getattr(args, "data_file", None),
+        context="data",
+        default=None,
+    )
+    if explicit is None:
+        return default_payload
+    if not isinstance(explicit, dict):
+        print("ERROR: search payload must be a JSON object", file=sys.stderr)
+        sys.exit(2)
+    return explicit
+
+
+def cmd_search_companies(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload = _load_search_payload(
+        args,
+        default_payload={
+            "query": str(getattr(args, "query", "") or "").strip(),
+            "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+        },
+    )
+    data = _request_api(
+        "POST",
+        "/api/search/companies",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_search_people(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload: Dict[str, Any] = {
+        "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+    }
+    query = str(getattr(args, "query", "") or "").strip()
+    company = str(getattr(args, "company", "") or "").strip()
+    location = str(getattr(args, "location", "") or "").strip()
+    if query:
+        payload["query"] = query
+    if company:
+        payload["company"] = company
+    if location:
+        payload["location"] = location
+    raw_skills = getattr(args, "skill", None) or []
+    skills: List[str] = []
+    for raw in raw_skills:
+        skills.extend([part.strip() for part in str(raw).split(",") if part.strip()])
+    if skills:
+        payload["skills"] = skills
+    payload = _load_search_payload(args, default_payload=payload)
+    data = _request_api(
+        "POST",
+        "/api/search/people",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_search_similar_companies(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload = _load_search_payload(
+        args,
+        default_payload={
+            "company_name": str(getattr(args, "company_name", "") or "").strip(),
+            "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+        },
+    )
+    data = _request_api(
+        "POST",
+        "/api/search/similar-companies",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_search_news(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload = _load_search_payload(
+        args,
+        default_payload={
+            "query": str(getattr(args, "query", "") or "").strip(),
+            "days_back": max(1, min(int(getattr(args, "days_back", 7) or 7), 365)),
+            "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+        },
+    )
+    data = _request_api(
+        "POST",
+        "/api/search/news",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_search_local_businesses(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload = _load_search_payload(
+        args,
+        default_payload={
+            "query": str(getattr(args, "query", "") or "").strip(),
+            "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+            "country": str(getattr(args, "country", "us") or "us").strip(),
+            "language": str(getattr(args, "language", "en") or "en").strip(),
+            "page": max(1, int(getattr(args, "page", 1) or 1)),
+        },
+    )
+    data = _request_api(
+        "POST",
+        "/api/search/local-businesses",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_search_reviews(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    payload: Dict[str, Any] = {
+        "sort_by": str(getattr(args, "sort_by", "newest") or "newest").strip(),
+        "limit": max(1, min(int(getattr(args, "limit", 25) or 25), 100)),
+        "country": str(getattr(args, "country", "us") or "us").strip(),
+        "language": str(getattr(args, "language", "en") or "en").strip(),
+        "page": max(1, int(getattr(args, "page", 1) or 1)),
+    }
+    for field_name in ("cid", "place_id", "fid", "next_page_token"):
+        value = str(getattr(args, field_name, "") or "").strip()
+        if value:
+            payload[field_name] = value
+    payload = _load_search_payload(args, default_payload=payload)
+    data = _request_api(
+        "POST",
+        "/api/search/reviews",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
+def cmd_search_filings(args: argparse.Namespace) -> None:
+    token = _resolve_token(args.token, required=True)
+    filing_types: List[str] = []
+    for raw in getattr(args, "filing_type", None) or []:
+        filing_types.extend([part.strip() for part in str(raw).split(",") if part.strip()])
+    payload: Dict[str, Any] = {
+        "company_name": str(getattr(args, "company_name", "") or "").strip(),
+    }
+    if filing_types:
+        payload["filing_types"] = filing_types
+    payload = _load_search_payload(args, default_payload=payload)
+    data = _request_api(
+        "POST",
+        "/api/search/filings",
+        base_url=args.base_url,
+        token=token,
+        use_x_api_key=args.use_x_api_key,
+        payload=payload,
+        timeout=args.timeout,
+        verbose=args.verbose,
+    )
+    _print_json(data, compact=args.compact)
+
+
 # ---------------------------------------------------------------------------
 # LinkedIn commands
 # ---------------------------------------------------------------------------
@@ -6868,6 +7130,86 @@ def build_parser() -> argparse.ArgumentParser:
     _add_api_common_arguments(pc)
     pc.set_defaults(func=cmd_capabilities)
 
+    # search
+    psrch = sub.add_parser("search", help="Provider-hidden search and list-building operations")
+    search_sub = psrch.add_subparsers(dest="search_cmd", required=True)
+
+    psr = search_sub.add_parser("recipe", help="Print search payload recipes")
+    psr.add_argument("--type", choices=["all", *SEARCH_RECIPE_TYPES], default="all")
+    psr.add_argument("--out-file", help="Optional path to save the selected payload JSON")
+    _add_api_common_arguments(psr)
+    psr.set_defaults(func=cmd_search_recipe)
+
+    psc = search_sub.add_parser("companies", help="Find companies with provider-hidden neural search")
+    psc.add_argument("--query", help="Free-text company query")
+    psc.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    psc.add_argument("--data-json", help="Explicit request payload JSON")
+    psc.add_argument("--data-file", help="Path to request payload JSON file")
+    _add_api_common_arguments(psc)
+    psc.set_defaults(func=cmd_search_companies)
+
+    psp = search_sub.add_parser("people", help="Find people with provider-hidden neural search")
+    psp.add_argument("--query", help="Free-text role/persona query")
+    psp.add_argument("--company", help="Optional company name")
+    psp.add_argument("--location", help="Optional location")
+    psp.add_argument("--skill", action="append", help="Optional skill (repeatable; comma-separated also supported)")
+    psp.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    psp.add_argument("--data-json", help="Explicit request payload JSON")
+    psp.add_argument("--data-file", help="Path to request payload JSON file")
+    _add_api_common_arguments(psp)
+    psp.set_defaults(func=cmd_search_people)
+
+    pss = search_sub.add_parser("similar-companies", help="Find companies similar to a seed company")
+    pss.add_argument("--company-name", help="Seed company name")
+    pss.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    pss.add_argument("--data-json", help="Explicit request payload JSON")
+    pss.add_argument("--data-file", help="Path to request payload JSON file")
+    _add_api_common_arguments(pss)
+    pss.set_defaults(func=cmd_search_similar_companies)
+
+    psn = search_sub.add_parser("news", help="Search recent news")
+    psn.add_argument("--query", help="News query")
+    psn.add_argument("--days-back", type=int, default=7, help="Lookback window in days (default: 7)")
+    psn.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    psn.add_argument("--data-json", help="Explicit request payload JSON")
+    psn.add_argument("--data-file", help="Path to request payload JSON file")
+    _add_api_common_arguments(psn)
+    psn.set_defaults(func=cmd_search_news)
+
+    pslb = search_sub.add_parser("local-businesses", help="Search local businesses")
+    pslb.add_argument("--query", help="Local business query")
+    pslb.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    pslb.add_argument("--country", default="us", help="Country code (default: us)")
+    pslb.add_argument("--language", default="en", help="Language code (default: en)")
+    pslb.add_argument("--page", type=int, default=1, help="Page number (default: 1)")
+    pslb.add_argument("--data-json", help="Explicit request payload JSON")
+    pslb.add_argument("--data-file", help="Path to request payload JSON file")
+    _add_api_common_arguments(pslb)
+    pslb.set_defaults(func=cmd_search_local_businesses)
+
+    psrv = search_sub.add_parser("reviews", help="Fetch reviews for a known listing")
+    psrv.add_argument("--cid", help="Listing CID")
+    psrv.add_argument("--place-id", help="Listing place_id")
+    psrv.add_argument("--fid", help="Listing fid")
+    psrv.add_argument("--sort-by", default="newest", help="Sort order (default: newest)")
+    psrv.add_argument("--limit", type=int, default=25, help="Max results, 1-100 (default: 25)")
+    psrv.add_argument("--country", default="us", help="Country code (default: us)")
+    psrv.add_argument("--language", default="en", help="Language code (default: en)")
+    psrv.add_argument("--next-page-token", help="Pagination token")
+    psrv.add_argument("--page", type=int, default=1, help="Page number (default: 1)")
+    psrv.add_argument("--data-json", help="Explicit request payload JSON")
+    psrv.add_argument("--data-file", help="Path to request payload JSON file")
+    _add_api_common_arguments(psrv)
+    psrv.set_defaults(func=cmd_search_reviews)
+
+    psf = search_sub.add_parser("filings", help="Research public company filings")
+    psf.add_argument("--company-name", help="Public company name")
+    psf.add_argument("--filing-type", action="append", help="Filing type (repeatable; comma-separated also supported)")
+    psf.add_argument("--data-json", help="Explicit request payload JSON")
+    psf.add_argument("--data-file", help="Path to request payload JSON file")
+    _add_api_common_arguments(psf)
+    psf.set_defaults(func=cmd_search_filings)
+
     # workflows
     pw = sub.add_parser("workflows", help="Common multi-step workflow blueprints")
     workflows_sub = pw.add_subparsers(dest="workflows_cmd", required=True)

{autotouch_cli-0.2.34 → autotouch_cli-0.2.35}/autotouch_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: autotouch-cli
-Version: 0.2.34
+Version: 0.2.35
 Summary: Autotouch Smart Table CLI
 Requires-Python: >=3.9
 Description-Content-Type: text/markdown

{autotouch_cli-0.2.34 → autotouch_cli-0.2.35}/autotouch_cli.egg-info/SOURCES.txt

@@ -11,4 +11,5 @@ autotouch_cli.egg-info/requires.txt
 autotouch_cli.egg-info/top_level.txt
 autotouch_shared/__init__.py
 autotouch_shared/linkedin_contract.py
-autotouch_shared/provider_registry.py
+autotouch_shared/provider_registry.py
+autotouch_shared/search_contract.py

{autotouch_cli-0.2.34 → autotouch_cli-0.2.35}/autotouch_shared/linkedin_contract.py

@@ -90,9 +90,33 @@ _LINKEDIN_ENDPOINTS: Dict[str, Dict[str, Any]] = {
 
 
 _LINKEDIN_CAPABILITIES: Dict[str, Any] = {
+    "surface_type": "connected_linkedin_search",
     "access_gate": "linkedin_access flag on user",
     "connection_required": True,
+    "requires_connected_account": True,
     "api_modes": ["classic", "sales_navigator"],
+    "best_for": [
+        "replaying a LinkedIn or Sales Navigator search URL",
+        "searching LinkedIn-native people, companies, jobs, or posts with a connected account",
+        "building engagement lists from LinkedIn posts, comments, or reactions",
+    ],
+    "not_for": [
+        "generic public-web company discovery",
+        "provider-hidden semantic people discovery when the source of truth is not specifically LinkedIn",
+    ],
+    "chooser_guidance": {
+        "use_linkedin_when": [
+            "the list source of truth is LinkedIn itself",
+            "you want to replay a LinkedIn or Sales Navigator search URL",
+            "you want comments, reactions, or recent post activity from LinkedIn",
+        ],
+        "company_first_when": [
+            "you need to discover the target accounts before looking for contacts",
+        ],
+        "people_first_when": [
+            "you already know the target companies and want role- or persona-based contacts",
+        ],
+    },
     "list_building_endpoints": [
         "/api/integrations/linkedin/search",
         "/api/integrations/linkedin/search/parameters",

autotouch_cli-0.2.35/autotouch_shared/search_contract.py

@@ -0,0 +1,233 @@
+"""Shared provider-hidden search contract for API capabilities, CLI recipes, and docs."""
+
+from __future__ import annotations
+
+from copy import deepcopy
+from typing import Any, Dict, Tuple
+
+
+SEARCH_SCOPE = "search:run"
+
+
+_SEARCH_ENDPOINTS: Dict[str, Dict[str, Any]] = {
+    "search_companies": {
+        "method": "POST",
+        "path": "/api/search/companies",
+        "required_scope": SEARCH_SCOPE,
+        "body": {
+            "query": "required free-text company search query",
+            "limit": "optional 1-100 (default 25)",
+        },
+        "response": {"items_field": "items", "item_type": "company"},
+    },
+    "search_people": {
+        "method": "POST",
+        "path": "/api/search/people",
+        "required_scope": SEARCH_SCOPE,
+        "body": {
+            "query": "optional free-text person/role query",
+            "company": "optional target company name",
+            "location": "optional location string",
+            "skills": "optional string[]",
+            "limit": "optional 1-100 (default 25)",
+        },
+        "response": {"items_field": "items", "item_type": "person"},
+    },
+    "search_similar_companies": {
+        "method": "POST",
+        "path": "/api/search/similar-companies",
+        "required_scope": SEARCH_SCOPE,
+        "body": {
+            "company_name": "required seed company name",
+            "limit": "optional 1-100 (default 25)",
+        },
+        "response": {"items_field": "items", "item_type": "company"},
+    },
+    "search_news": {
+        "method": "POST",
+        "path": "/api/search/news",
+        "required_scope": SEARCH_SCOPE,
+        "body": {
+            "query": "required free-text news query",
+            "days_back": "optional lookback window in days (default 7)",
+            "limit": "optional 1-100 (default 25)",
+        },
+        "response": {"items_field": "items", "item_type": "news_article"},
+    },
+    "search_local_businesses": {
+        "method": "POST",
+        "path": "/api/search/local-businesses",
+        "required_scope": SEARCH_SCOPE,
+        "body": {
+            "query": "required local business query",
+            "limit": "optional 1-100 (default 25)",
+            "country": "optional country code (default us)",
+            "language": "optional language code (default en)",
+            "page": "optional page number (default 1)",
+        },
+        "response": {"items_field": "items", "item_type": "local_business"},
+    },
+    "search_reviews": {
+        "method": "POST",
+        "path": "/api/search/reviews",
+        "required_scope": SEARCH_SCOPE,
+        "body": {
+            "cid": "optional listing CID",
+            "place_id": "optional place identifier",
+            "fid": "optional listing fid",
+            "sort_by": "optional newest|relevance|rating (default newest)",
+            "limit": "optional 1-100 (default 25)",
+            "country": "optional country code (default us)",
+            "language": "optional language code (default en)",
+            "next_page_token": "optional pagination token",
+            "page": "optional page number (default 1)",
+        },
+        "response": {"items_field": "items", "item_type": "review"},
+    },
+    "search_filings": {
+        "method": "POST",
+        "path": "/api/search/filings",
+        "required_scope": SEARCH_SCOPE,
+        "body": {
+            "company_name": "required company name",
+            "filing_types": "optional string[] (default ['10-K','10-Q'])",
+        },
+        "response": {"items_field": "items", "item_type": "filing"},
+    },
+}
+
+
+_SEARCH_CAPABILITIES: Dict[str, Any] = {
+    "surface_type": "provider_hidden_search",
+    "connection_required": False,
+    "requires_connected_account": False,
+    "recommended_scope": SEARCH_SCOPE,
+    "chooser_guidance": {
+        "use_company_search_when": [
+            "you need to discover target accounts before looking for contacts",
+            "the search criteria are market, product, or industry driven",
+        ],
+        "use_people_search_when": [
+            "you already know the target companies",
+            "the search criteria are role, persona, or skill driven",
+        ],
+        "use_linkedin_instead_when": [
+            "the source of truth is a LinkedIn or Sales Navigator search URL",
+            "you need LinkedIn-native posts, comments, reactions, or engagement lists",
+        ],
+    },
+    "pricing": {
+        "charge_on": "actual_results_returned",
+        "families": {
+            "companies": {"credits_per_bucket": 1, "bucket_size": 10, "rule": "1 credit per 10 results"},
+            "people": {"credits_per_bucket": 1, "bucket_size": 10, "rule": "1 credit per 10 results"},
+            "similar_companies": {"credits_per_bucket": 1, "bucket_size": 10, "rule": "1 credit per 10 results"},
+            "news": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
+            "local_businesses": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
+            "reviews": {"credits_per_bucket": 1, "bucket_size": 25, "rule": "1 credit per 25 results"},
+            "filings": {"credits_per_bucket": 1, "bucket_size": 1, "rule": "1 credit per search"},
+        },
+    },
+    "recommended_cli": [
+        "autotouch search companies --query 'remote IT asset management' --limit 25",
+        "autotouch search people --query 'VP IT' --company 'Rippling' --limit 25",
+        "autotouch search recipe --type companies --out-file companies.json",
+    ],
+}
+
+
+_SEARCH_RECIPES: Dict[str, Dict[str, Any]] = {
+    "companies": {
+        "payload": {"query": "remote IT asset management", "limit": 25},
+        "usage": "autotouch search companies --data-file <payload.json>",
+        "notes": [
+            "Use this when you need to discover target accounts first.",
+            "Pricing: 1 credit per 10 returned companies.",
+        ],
+    },
+    "people": {
+        "payload": {
+            "query": "VP IT",
+            "company": "Rippling",
+            "location": "United States",
+            "skills": ["endpoint management", "IT operations"],
+            "limit": 25,
+        },
+        "usage": "autotouch search people --data-file <payload.json>",
+        "notes": [
+            "Use this when you already know the target companies or persona.",
+            "Pricing: 1 credit per 10 returned people.",
+        ],
+    },
+    "similar_companies": {
+        "payload": {"company_name": "Rippling", "limit": 25},
+        "usage": "autotouch search similar-companies --data-file <payload.json>",
+        "notes": [
+            "Good for expanding a seed account list.",
+            "Pricing: 1 credit per 10 returned companies.",
+        ],
+    },
+    "news": {
+        "payload": {"query": "device management startups", "days_back": 14, "limit": 25},
+        "usage": "autotouch search news --data-file <payload.json>",
+        "notes": [
+            "Use for recent intent signals and market monitoring.",
+            "Pricing: 1 credit per 25 returned articles.",
+        ],
+    },
+    "local_businesses": {
+        "payload": {"query": "managed IT services austin texas", "limit": 25, "country": "us", "language": "en"},
+        "usage": "autotouch search local-businesses --data-file <payload.json>",
+        "notes": [
+            "Best for local business or maps-style discovery.",
+            "Pricing: 1 credit per 25 returned businesses.",
+        ],
+    },
+    "reviews": {
+        "payload": {"cid": "<GOOGLE_MAPS_CID>", "limit": 25, "sort_by": "newest"},
+        "usage": "autotouch search reviews --data-file <payload.json>",
+        "notes": [
+            "Resolve the listing first from local-business search, then fetch reviews.",
+            "Pricing: 1 credit per 25 returned reviews.",
+        ],
+    },
+    "filings": {
+        "payload": {"company_name": "Snowflake", "filing_types": ["10-K", "10-Q"]},
+        "usage": "autotouch search filings --data-file <payload.json>",
+        "notes": [
+            "Use for public-company filings and SEC research.",
+            "Pricing: 1 credit per successful search.",
+        ],
+    },
+}
+
+
+def search_endpoint_entries() -> Dict[str, Dict[str, Any]]:
+    return deepcopy(_SEARCH_ENDPOINTS)
+
+
+def search_capabilities_contract() -> Dict[str, Any]:
+    return deepcopy(_SEARCH_CAPABILITIES)
+
+
+def search_recipe_types() -> Tuple[str, ...]:
+    return tuple(_SEARCH_RECIPES.keys())
+
+
+def search_recipe_entries() -> Dict[str, Dict[str, Any]]:
+    return deepcopy(_SEARCH_RECIPES)
+
+
+def search_recipe_entry(recipe_type: str) -> Dict[str, Any] | None:
+    recipe = _SEARCH_RECIPES.get(str(recipe_type or "").strip())
+    return deepcopy(recipe) if isinstance(recipe, dict) else None
+
+
+__all__ = [
+    "SEARCH_SCOPE",
+    "search_capabilities_contract",
+    "search_endpoint_entries",
+    "search_recipe_entries",
+    "search_recipe_entry",
+    "search_recipe_types",
+]

{autotouch_cli-0.2.34 → autotouch_cli-0.2.35}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "autotouch-cli"
-version = "0.2.34"
+version = "0.2.35"
 description = "Autotouch Smart Table CLI"
 readme = "README.md"
 requires-python = ">=3.9"