moveezi 1.0.0__tar.gz

moveezi-1.0.0/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: moveezi
+Version: 1.0.0
+Summary: Client for the public Moveezi API: read moveezi.com as structured data, search it, and reach the sales team. No credentials needed.
+Author-email: Dumont Pty Ltd <sales@moveezi.com>
+License-Expression: MIT
+Project-URL: Homepage, https://www.moveezi.com/developers
+Project-URL: Documentation, https://www.moveezi.com/openapi.json
+Project-URL: Repository, https://github.com/DumontAI/moveezi-sdk
+Project-URL: Issues, https://github.com/DumontAI/moveezi-sdk/issues
+Keywords: moveezi,moving,relocation,storage,logistics,api,sdk,mcp,agent,llm
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Moveezi SDK
+
+Client libraries and a CLI for the public [Moveezi](https://www.moveezi.com/) API.
+
+[Moveezi](https://www.moveezi.com/) is the operating system for moving, relocation and
+storage companies: sales and quoting, on-site and video surveys, dispatch and crew
+scheduling, a mobile crew app, warehousing, sea/air/road shipment tracking, a live control
+tower and per-job profit and loss.
+
+**There is nothing to authenticate with.** No key, no signup, no token. Every read is open.
+The one write, `submitLead`, is the same endpoint the website's own forms post to, and it
+has a sandbox so you can check a payload without creating anything.
+
+- API reference: <https://www.moveezi.com/openapi.json>
+- Developer portal: <https://www.moveezi.com/developers>
+- MCP server: `https://www.moveezi.com/mcp` (Streamable HTTP, no credentials)
+- Authentication, in one page: <https://www.moveezi.com/auth.md>
+
+## Install
+
+**JavaScript / TypeScript** (Node 18+, zero dependencies):
+
+```bash
+npm install moveezi
+# or straight from source, no registry account needed:
+npm install DumontAI/moveezi-sdk
+```
+
+**Python** (3.9+, standard library only):
+
+```bash
+pip install moveezi
+```
+
+**CLI**, without installing anything:
+
+```bash
+npx moveezi search "video survey"
+```
+
+## Use it
+
+```js
+import { MoveeziClient } from "moveezi";
+
+const moveezi = new MoveeziClient();
+
+const hits = await moveezi.searchSite("video survey", { limit: 3 });
+const pricing = await moveezi.getPage("pricing", { format: "markdown" });
+const pages = await moveezi.allPages({ prefix: "blog/" });
+
+// Check a lead before you send one. Creates nothing.
+const check = await moveezi.validateLead({ name: "Ada", email: "ada@example.com" });
+if (check.wouldSubmit) {
+  await moveezi.submitLead(
+    { name: "Ada", email: "ada@example.com", intent: "demo" },
+    { idempotencyKey: crypto.randomUUID() },   // a retry will not create a second lead
+  );
+}
+```
+
+```python
+from moveezi import Moveezi
+
+moveezi = Moveezi()
+hits = moveezi.search("video survey", limit=3)
+pricing = moveezi.get_page("pricing", markdown=True)
+pages = list(moveezi.all_pages(prefix="blog/"))
+
+check = moveezi.validate_lead({"name": "Ada", "email": "ada@example.com"})
+if check["wouldSubmit"]:
+    moveezi.submit_lead({"name": "Ada", "email": "ada@example.com"},
+                        idempotency_key="a3f1c9e2")
+```
+
+## CLI
+
+```
+moveezi search <query>     Search moveezi.com
+moveezi page <slug>        One page as markdown
+moveezi pages [--prefix]   Every published page
+moveezi batch <slug...>    Several pages in one request
+moveezi pricing            The pricing page
+moveezi lead [--submit]    Check a lead; only sends with --submit
+moveezi openapi            The OpenAPI 3.1 document
+moveezi auth               How to authenticate here (you do not)
+moveezi policy             Versioning and deprecation policy
+moveezi mcp                MCP endpoint and client config
+```
+
+## Rate limits
+
+Reads are 120 requests per minute per IP. `POST /api/lead` is 5 per hour per IP. Both
+report `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` and `RateLimit-Policy`
+on every response, and `Retry-After` on a 429. Both clients expose them:
+
+```js
+await moveezi.listPages();
+moveezi.lastRateLimit;        // { limit: 120, remaining: 119, reset: 60 }
+```
+
+A 429 throws a `MoveeziError` with `retryAfter` in seconds, so you can back off on real
+numbers rather than guessing.
+
+## If you are an AI agent
+
+You may not need this package at all. The API is plain HTTP with an
+[OpenAPI 3.1 document](https://www.moveezi.com/openapi.json), every page is available as
+markdown (append `.md`, or send `Accept: text/markdown`), and there is an
+[MCP server](https://www.moveezi.com/mcp) with tools for search, page retrieval and
+pricing. Start at [llms.txt](https://www.moveezi.com/llms.txt).
+
+Please only call `submitLead` on behalf of a person who asked you to contact Moveezi, and
+send an `Idempotency-Key` so a retry does not create a duplicate. `validateLead` is there
+so you never have to learn the rules by creating a bad record.
+
+## Stability
+
+The version is in the path (`/api/v1`) and this API changes additively within it. Anything
+being withdrawn gets `Deprecation` and `Sunset` headers and six months' notice first. Full
+policy: <https://www.moveezi.com/api-deprecation-policy>.
+
+## Development
+
+```bash
+npm test                                   # JavaScript, no network
+MOVEEZI_LIVE=1 npm test                    # plus a couple against production
+cd python && python3 -m unittest test_moveezi
+```
+
+## Licence
+
+MIT. See [LICENSE](LICENSE). The API and the content it serves belong to Dumont Pty Ltd.

moveezi-1.0.0/README.md

@@ -0,0 +1,133 @@
+# Moveezi SDK
+
+Client libraries and a CLI for the public [Moveezi](https://www.moveezi.com/) API.
+
+[Moveezi](https://www.moveezi.com/) is the operating system for moving, relocation and
+storage companies: sales and quoting, on-site and video surveys, dispatch and crew
+scheduling, a mobile crew app, warehousing, sea/air/road shipment tracking, a live control
+tower and per-job profit and loss.
+
+**There is nothing to authenticate with.** No key, no signup, no token. Every read is open.
+The one write, `submitLead`, is the same endpoint the website's own forms post to, and it
+has a sandbox so you can check a payload without creating anything.
+
+- API reference: <https://www.moveezi.com/openapi.json>
+- Developer portal: <https://www.moveezi.com/developers>
+- MCP server: `https://www.moveezi.com/mcp` (Streamable HTTP, no credentials)
+- Authentication, in one page: <https://www.moveezi.com/auth.md>
+
+## Install
+
+**JavaScript / TypeScript** (Node 18+, zero dependencies):
+
+```bash
+npm install moveezi
+# or straight from source, no registry account needed:
+npm install DumontAI/moveezi-sdk
+```
+
+**Python** (3.9+, standard library only):
+
+```bash
+pip install moveezi
+```
+
+**CLI**, without installing anything:
+
+```bash
+npx moveezi search "video survey"
+```
+
+## Use it
+
+```js
+import { MoveeziClient } from "moveezi";
+
+const moveezi = new MoveeziClient();
+
+const hits = await moveezi.searchSite("video survey", { limit: 3 });
+const pricing = await moveezi.getPage("pricing", { format: "markdown" });
+const pages = await moveezi.allPages({ prefix: "blog/" });
+
+// Check a lead before you send one. Creates nothing.
+const check = await moveezi.validateLead({ name: "Ada", email: "ada@example.com" });
+if (check.wouldSubmit) {
+  await moveezi.submitLead(
+    { name: "Ada", email: "ada@example.com", intent: "demo" },
+    { idempotencyKey: crypto.randomUUID() },   // a retry will not create a second lead
+  );
+}
+```
+
+```python
+from moveezi import Moveezi
+
+moveezi = Moveezi()
+hits = moveezi.search("video survey", limit=3)
+pricing = moveezi.get_page("pricing", markdown=True)
+pages = list(moveezi.all_pages(prefix="blog/"))
+
+check = moveezi.validate_lead({"name": "Ada", "email": "ada@example.com"})
+if check["wouldSubmit"]:
+    moveezi.submit_lead({"name": "Ada", "email": "ada@example.com"},
+                        idempotency_key="a3f1c9e2")
+```
+
+## CLI
+
+```
+moveezi search <query>     Search moveezi.com
+moveezi page <slug>        One page as markdown
+moveezi pages [--prefix]   Every published page
+moveezi batch <slug...>    Several pages in one request
+moveezi pricing            The pricing page
+moveezi lead [--submit]    Check a lead; only sends with --submit
+moveezi openapi            The OpenAPI 3.1 document
+moveezi auth               How to authenticate here (you do not)
+moveezi policy             Versioning and deprecation policy
+moveezi mcp                MCP endpoint and client config
+```
+
+## Rate limits
+
+Reads are 120 requests per minute per IP. `POST /api/lead` is 5 per hour per IP. Both
+report `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` and `RateLimit-Policy`
+on every response, and `Retry-After` on a 429. Both clients expose them:
+
+```js
+await moveezi.listPages();
+moveezi.lastRateLimit;        // { limit: 120, remaining: 119, reset: 60 }
+```
+
+A 429 throws a `MoveeziError` with `retryAfter` in seconds, so you can back off on real
+numbers rather than guessing.
+
+## If you are an AI agent
+
+You may not need this package at all. The API is plain HTTP with an
+[OpenAPI 3.1 document](https://www.moveezi.com/openapi.json), every page is available as
+markdown (append `.md`, or send `Accept: text/markdown`), and there is an
+[MCP server](https://www.moveezi.com/mcp) with tools for search, page retrieval and
+pricing. Start at [llms.txt](https://www.moveezi.com/llms.txt).
+
+Please only call `submitLead` on behalf of a person who asked you to contact Moveezi, and
+send an `Idempotency-Key` so a retry does not create a duplicate. `validateLead` is there
+so you never have to learn the rules by creating a bad record.
+
+## Stability
+
+The version is in the path (`/api/v1`) and this API changes additively within it. Anything
+being withdrawn gets `Deprecation` and `Sunset` headers and six months' notice first. Full
+policy: <https://www.moveezi.com/api-deprecation-policy>.
+
+## Development
+
+```bash
+npm test                                   # JavaScript, no network
+MOVEEZI_LIVE=1 npm test                    # plus a couple against production
+cd python && python3 -m unittest test_moveezi
+```
+
+## Licence
+
+MIT. See [LICENSE](LICENSE). The API and the content it serves belong to Dumont Pty Ltd.

moveezi-1.0.0/moveezi/__init__.py

@@ -0,0 +1,189 @@
+"""Client for the public Moveezi API.
+
+There is nothing to authenticate with: every read is open, and the one write
+(``submit_lead``) is the same endpoint the website's own forms post to. The
+description this mirrors is at https://www.moveezi.com/openapi.json.
+
+Standard library only, so it installs anywhere without pulling a dependency
+tree behind it.
+
+    >>> from moveezi import Moveezi
+    >>> Moveezi().search("video survey")["count"]        # doctest: +SKIP
+    5
+"""
+from __future__ import annotations
+
+import json
+import urllib.error
+import urllib.parse
+import urllib.request
+from typing import Any, Dict, Iterator, List, Optional
+
+__all__ = ["Moveezi", "MoveeziError", "MCP_ENDPOINT", "MCP_MANIFEST", "__version__"]
+
+__version__ = "1.0.0"
+
+BASE = "https://www.moveezi.com"
+MCP_ENDPOINT = BASE + "/mcp"
+MCP_MANIFEST = BASE + "/.well-known/mcp.json"
+_UA = "moveezi-sdk-python/%s (+https://www.moveezi.com/developers)" % __version__
+
+
+class MoveeziError(Exception):
+    """Any non-2xx response, carrying what the API said and its limits."""
+
+    def __init__(self, message: str, status: Optional[int] = None,
+                 body: Any = None, rate_limit: Optional[Dict[str, int]] = None,
+                 retry_after: Optional[int] = None) -> None:
+        super().__init__(message)
+        self.status = status
+        self.body = body
+        self.rate_limit = rate_limit
+        #: Seconds to wait. Present on a 429.
+        self.retry_after = retry_after
+
+
+def _rate_limit(headers) -> Optional[Dict[str, int]]:
+    limit = headers.get("RateLimit-Limit")
+    if limit is None:
+        return None
+    out = {"limit": int(limit)}
+    for key, name in (("remaining", "RateLimit-Remaining"), ("reset", "RateLimit-Reset")):
+        value = headers.get(name)
+        if value is not None:
+            out[key] = int(value)
+    return out
+
+
+class Moveezi:
+    """The public Moveezi API. No credentials, no setup."""
+
+    def __init__(self, base_url: str = BASE, timeout: float = 30.0,
+                 user_agent: str = _UA) -> None:
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+        self.user_agent = user_agent
+        #: Rate-limit headers from the most recent response.
+        self.last_rate_limit: Optional[Dict[str, int]] = None
+
+    # -- plumbing ---------------------------------------------------------
+    def _request(self, path: str, method: str = "GET", body: Any = None,
+                 accept: str = "application/json") -> Any:
+        data = None if body is None else json.dumps(body).encode("utf-8")
+        headers = {"Accept": accept, "User-Agent": self.user_agent}
+        if data is not None:
+            headers["Content-Type"] = "application/json"
+        request = urllib.request.Request(self.base_url + path, data=data,
+                                         headers=headers, method=method)
+        try:
+            with urllib.request.urlopen(request, timeout=self.timeout) as response:
+                self.last_rate_limit = _rate_limit(response.headers)
+                raw = response.read().decode("utf-8")
+                ctype = response.headers.get("Content-Type", "")
+                return json.loads(raw) if "json" in ctype else raw
+        except urllib.error.HTTPError as err:
+            raw = err.read().decode("utf-8", "replace")
+            try:
+                payload = json.loads(raw)
+            except ValueError:
+                payload = raw
+            self.last_rate_limit = _rate_limit(err.headers)
+            # 422 from the sandbox is the answer the caller asked for, not a failure.
+            if err.code == 422 and path.startswith("/api/v1/lead/validate"):
+                return payload
+            retry = err.headers.get("Retry-After")
+            message = (payload.get("error") if isinstance(payload, dict)
+                       else None) or "Moveezi API returned %s" % err.code
+            raise MoveeziError(message, status=err.code, body=payload,
+                               rate_limit=self.last_rate_limit,
+                               retry_after=int(retry) if retry else None) from None
+
+    # -- content ----------------------------------------------------------
+    def list_pages(self, limit: Optional[int] = None, cursor: Optional[str] = None,
+                   prefix: Optional[str] = None) -> Dict[str, Any]:
+        """One page of the page index. Follow ``nextCursor`` for the rest."""
+        query = {k: v for k, v in (("limit", limit), ("cursor", cursor),
+                                   ("prefix", prefix)) if v is not None}
+        suffix = "?" + urllib.parse.urlencode(query) if query else ""
+        return self._request("/api/v1/pages" + suffix)
+
+    def all_pages(self, prefix: Optional[str] = None) -> Iterator[Dict[str, Any]]:
+        """Every page, following the cursor for you."""
+        cursor = None
+        while True:
+            batch = self.list_pages(limit=100, cursor=cursor, prefix=prefix)
+            for page in batch["pages"]:
+                yield page
+            cursor = batch.get("nextCursor")
+            if not cursor:
+                return
+
+    def get_page(self, slug: str, markdown: bool = False):
+        """One page. ``markdown=True`` returns the markdown document as a string."""
+        path = "/api/v1/pages/" + slug.strip("/")
+        return self._request(path, accept="text/markdown" if markdown else "application/json")
+
+    def get_pages(self, slugs: List[str]) -> Dict[str, Any]:
+        """Up to 50 pages in one round trip. Missing slugs come back marked."""
+        return self._request("/api/v1/pages/batch", "POST", {"slugs": list(slugs)})
+
+    def search(self, query: str, limit: Optional[int] = None) -> Dict[str, Any]:
+        """Ranked full-text search across the site."""
+        params = {"q": query}
+        if limit is not None:
+            params["limit"] = limit
+        return self._request("/api/v1/search?" + urllib.parse.urlencode(params))
+
+    # -- sales ------------------------------------------------------------
+    def validate_lead(self, lead: Dict[str, Any]) -> Dict[str, Any]:
+        """Check a lead against the same rules as ``submit_lead``, writing nothing."""
+        return self._request("/api/v1/lead/validate", "POST", lead)
+
+    def submit_lead(self, lead: Dict[str, Any],
+                    idempotency_key: Optional[str] = None) -> Dict[str, Any]:
+        """Send an enquiry to the Moveezi sales team.
+
+        This creates a CRM record and emails a human, so only call it on behalf
+        of someone who asked you to. With an ``idempotency_key``, a retry
+        replays the first response instead of creating a second lead.
+        """
+        data = json.dumps(lead).encode("utf-8")
+        headers = {"Accept": "application/json", "Content-Type": "application/json",
+                   "User-Agent": self.user_agent}
+        if idempotency_key:
+            headers["Idempotency-Key"] = idempotency_key
+        request = urllib.request.Request(self.base_url + "/api/lead", data=data,
+                                         headers=headers, method="POST")
+        try:
+            with urllib.request.urlopen(request, timeout=self.timeout) as response:
+                self.last_rate_limit = _rate_limit(response.headers)
+                return json.loads(response.read().decode("utf-8"))
+        except urllib.error.HTTPError as err:
+            raw = err.read().decode("utf-8", "replace")
+            try:
+                payload = json.loads(raw)
+            except ValueError:
+                payload = raw
+            retry = err.headers.get("Retry-After")
+            raise MoveeziError(
+                (payload.get("error") if isinstance(payload, dict) else None)
+                or "Moveezi API returned %s" % err.code,
+                status=err.code, body=payload, rate_limit=_rate_limit(err.headers),
+                retry_after=int(retry) if retry else None) from None
+
+    # -- documents --------------------------------------------------------
+    def openapi(self) -> Dict[str, Any]:
+        """The OpenAPI 3.1 description of everything above."""
+        return self._request("/openapi.json")
+
+    def sandbox(self) -> Dict[str, Any]:
+        """Where the sandbox is and what it covers."""
+        return self._request("/api/v1/sandbox")
+
+    def auth_doc(self) -> str:
+        """How authentication works here, which is: it does not."""
+        return self._request("/auth.md", accept="text/markdown")
+
+    def deprecation_policy(self) -> str:
+        """How this API is allowed to change, and how much notice you get."""
+        return self._request("/api-deprecation-policy", accept="text/markdown")

moveezi-1.0.0/moveezi/__main__.py

@@ -0,0 +1,115 @@
+"""`python -m moveezi` / the `moveezi` console script."""
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from . import MCP_ENDPOINT, Moveezi, MoveeziError, __version__
+
+LEAD_FIELDS = ("name", "email", "company", "phone", "dialcode", "country",
+               "message", "intent", "segment", "warehouses", "moves")
+
+
+def main(argv=None) -> int:
+    parser = argparse.ArgumentParser(
+        prog="moveezi",
+        description="Read moveezi.com from a terminal. Nothing here needs a key.")
+    parser.add_argument("--version", action="version", version=__version__)
+    parser.add_argument("--base", default=None, help="point at a different host")
+    parser.add_argument("--json", action="store_true", help="raw JSON instead of text")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    p = sub.add_parser("search", help="search moveezi.com")
+    p.add_argument("query", nargs="+")
+    p.add_argument("--limit", type=int)
+
+    p = sub.add_parser("page", help="one page as markdown")
+    p.add_argument("slug")
+
+    p = sub.add_parser("pages", help="every published page")
+    p.add_argument("--prefix")
+
+    p = sub.add_parser("lead", help="check a lead; --submit to actually send it")
+    for field in LEAD_FIELDS:
+        p.add_argument("--" + field)
+    p.add_argument("--idempotency-key")
+    p.add_argument("--submit", action="store_true")
+
+    sub.add_parser("openapi", help="the OpenAPI 3.1 document")
+    sub.add_parser("auth", help="how to authenticate here (you do not)")
+    sub.add_parser("policy", help="versioning and deprecation policy")
+    sub.add_parser("mcp", help="MCP endpoint and client config")
+
+    args = parser.parse_args(argv)
+    client = Moveezi(args.base) if args.base else Moveezi()
+
+    def out(value):
+        if args.json or not isinstance(value, str):
+            print(json.dumps(value, indent=2))
+        else:
+            print(value)
+
+    try:
+        if args.command == "search":
+            data = client.search(" ".join(args.query), args.limit)
+            if args.json:
+                return out(data) or 0
+            if not data["count"]:
+                print("Nothing on moveezi.com matches that.")
+                return 0
+            for r in data["results"]:
+                print("\n%s\n  %s\n  %s" % (r["title"], r["url"], r["snippet"]))
+            return 0
+        if args.command == "page":
+            out(client.get_page(args.slug, markdown=not args.json))
+            return 0
+        if args.command == "pages":
+            pages = list(client.all_pages(args.prefix))
+            if args.json:
+                return out(pages) or 0
+            for p in pages:
+                print("%-34s %s" % (p["slug"], p["title"]))
+            return 0
+        if args.command == "lead":
+            lead = {f: getattr(args, f) for f in LEAD_FIELDS if getattr(args, f)}
+            if args.submit:
+                out(client.submit_lead(lead, args.idempotency_key))
+                return 0
+            res = client.validate_lead(lead)
+            if args.json:
+                return out(res) or 0
+            if res["wouldSubmit"]:
+                print("Looks good. Nothing was sent - add --submit to send it.")
+                return 0
+            print("This would be rejected:")
+            for problem in res["problems"]:
+                print("  %s: %s" % (problem["field"], problem["error"]))
+            return 1
+        if args.command == "openapi":
+            return out(client.openapi()) or 0
+        if args.command == "auth":
+            return out(client.auth_doc()) or 0
+        if args.command == "policy":
+            return out(client.deprecation_policy()) or 0
+        if args.command == "mcp":
+            config = {"mcpServers": {"moveezi": {"type": "http", "url": MCP_ENDPOINT}}}
+            if args.json:
+                return out(config) or 0
+            print("Moveezi speaks MCP over Streamable HTTP.\n\n  %s\n\n"
+                  "Claude Code:\n  claude mcp add --transport http moveezi %s\n\n"
+                  "Any client that reads a config file:\n%s\n\n"
+                  "No credentials. Tools: search_moveezi_site, get_moveezi_page,\n"
+                  "list_moveezi_pages, get_moveezi_pricing."
+                  % (MCP_ENDPOINT, MCP_ENDPOINT, json.dumps(config, indent=2)))
+            return 0
+    except MoveeziError as err:
+        print("moveezi: %s" % err, file=sys.stderr)
+        if err.retry_after:
+            print("  rate limited; retry in %ss" % err.retry_after, file=sys.stderr)
+        return 1
+    return 2
+
+
+if __name__ == "__main__":
+    sys.exit(main())

moveezi-1.0.0/moveezi.egg-info/PKG-INFO

@@ -0,0 +1,152 @@
+Metadata-Version: 2.4
+Name: moveezi
+Version: 1.0.0
+Summary: Client for the public Moveezi API: read moveezi.com as structured data, search it, and reach the sales team. No credentials needed.
+Author-email: Dumont Pty Ltd <sales@moveezi.com>
+License-Expression: MIT
+Project-URL: Homepage, https://www.moveezi.com/developers
+Project-URL: Documentation, https://www.moveezi.com/openapi.json
+Project-URL: Repository, https://github.com/DumontAI/moveezi-sdk
+Project-URL: Issues, https://github.com/DumontAI/moveezi-sdk/issues
+Keywords: moveezi,moving,relocation,storage,logistics,api,sdk,mcp,agent,llm
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Office/Business
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+
+# Moveezi SDK
+
+Client libraries and a CLI for the public [Moveezi](https://www.moveezi.com/) API.
+
+[Moveezi](https://www.moveezi.com/) is the operating system for moving, relocation and
+storage companies: sales and quoting, on-site and video surveys, dispatch and crew
+scheduling, a mobile crew app, warehousing, sea/air/road shipment tracking, a live control
+tower and per-job profit and loss.
+
+**There is nothing to authenticate with.** No key, no signup, no token. Every read is open.
+The one write, `submitLead`, is the same endpoint the website's own forms post to, and it
+has a sandbox so you can check a payload without creating anything.
+
+- API reference: <https://www.moveezi.com/openapi.json>
+- Developer portal: <https://www.moveezi.com/developers>
+- MCP server: `https://www.moveezi.com/mcp` (Streamable HTTP, no credentials)
+- Authentication, in one page: <https://www.moveezi.com/auth.md>
+
+## Install
+
+**JavaScript / TypeScript** (Node 18+, zero dependencies):
+
+```bash
+npm install moveezi
+# or straight from source, no registry account needed:
+npm install DumontAI/moveezi-sdk
+```
+
+**Python** (3.9+, standard library only):
+
+```bash
+pip install moveezi
+```
+
+**CLI**, without installing anything:
+
+```bash
+npx moveezi search "video survey"
+```
+
+## Use it
+
+```js
+import { MoveeziClient } from "moveezi";
+
+const moveezi = new MoveeziClient();
+
+const hits = await moveezi.searchSite("video survey", { limit: 3 });
+const pricing = await moveezi.getPage("pricing", { format: "markdown" });
+const pages = await moveezi.allPages({ prefix: "blog/" });
+
+// Check a lead before you send one. Creates nothing.
+const check = await moveezi.validateLead({ name: "Ada", email: "ada@example.com" });
+if (check.wouldSubmit) {
+  await moveezi.submitLead(
+    { name: "Ada", email: "ada@example.com", intent: "demo" },
+    { idempotencyKey: crypto.randomUUID() },   // a retry will not create a second lead
+  );
+}
+```
+
+```python
+from moveezi import Moveezi
+
+moveezi = Moveezi()
+hits = moveezi.search("video survey", limit=3)
+pricing = moveezi.get_page("pricing", markdown=True)
+pages = list(moveezi.all_pages(prefix="blog/"))
+
+check = moveezi.validate_lead({"name": "Ada", "email": "ada@example.com"})
+if check["wouldSubmit"]:
+    moveezi.submit_lead({"name": "Ada", "email": "ada@example.com"},
+                        idempotency_key="a3f1c9e2")
+```
+
+## CLI
+
+```
+moveezi search <query>     Search moveezi.com
+moveezi page <slug>        One page as markdown
+moveezi pages [--prefix]   Every published page
+moveezi batch <slug...>    Several pages in one request
+moveezi pricing            The pricing page
+moveezi lead [--submit]    Check a lead; only sends with --submit
+moveezi openapi            The OpenAPI 3.1 document
+moveezi auth               How to authenticate here (you do not)
+moveezi policy             Versioning and deprecation policy
+moveezi mcp                MCP endpoint and client config
+```
+
+## Rate limits
+
+Reads are 120 requests per minute per IP. `POST /api/lead` is 5 per hour per IP. Both
+report `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` and `RateLimit-Policy`
+on every response, and `Retry-After` on a 429. Both clients expose them:
+
+```js
+await moveezi.listPages();
+moveezi.lastRateLimit;        // { limit: 120, remaining: 119, reset: 60 }
+```
+
+A 429 throws a `MoveeziError` with `retryAfter` in seconds, so you can back off on real
+numbers rather than guessing.
+
+## If you are an AI agent
+
+You may not need this package at all. The API is plain HTTP with an
+[OpenAPI 3.1 document](https://www.moveezi.com/openapi.json), every page is available as
+markdown (append `.md`, or send `Accept: text/markdown`), and there is an
+[MCP server](https://www.moveezi.com/mcp) with tools for search, page retrieval and
+pricing. Start at [llms.txt](https://www.moveezi.com/llms.txt).
+
+Please only call `submitLead` on behalf of a person who asked you to contact Moveezi, and
+send an `Idempotency-Key` so a retry does not create a duplicate. `validateLead` is there
+so you never have to learn the rules by creating a bad record.
+
+## Stability
+
+The version is in the path (`/api/v1`) and this API changes additively within it. Anything
+being withdrawn gets `Deprecation` and `Sunset` headers and six months' notice first. Full
+policy: <https://www.moveezi.com/api-deprecation-policy>.
+
+## Development
+
+```bash
+npm test                                   # JavaScript, no network
+MOVEEZI_LIVE=1 npm test                    # plus a couple against production
+cd python && python3 -m unittest test_moveezi
+```
+
+## Licence
+
+MIT. See [LICENSE](LICENSE). The API and the content it serves belong to Dumont Pty Ltd.

moveezi-1.0.0/moveezi.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+moveezi/__init__.py
+moveezi/__main__.py
+moveezi.egg-info/PKG-INFO
+moveezi.egg-info/SOURCES.txt
+moveezi.egg-info/dependency_links.txt
+moveezi.egg-info/entry_points.txt
+moveezi.egg-info/top_level.txt

moveezi-1.0.0/moveezi.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

moveezi-1.0.0/moveezi.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+moveezi = moveezi.__main__:main

moveezi-1.0.0/moveezi.egg-info/top_level.txt

@@ -0,0 +1 @@
+moveezi

moveezi-1.0.0/pyproject.toml

@@ -0,0 +1,33 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "moveezi"
+version = "1.0.0"
+description = "Client for the public Moveezi API: read moveezi.com as structured data, search it, and reach the sales team. No credentials needed."
+readme = "README.md"
+requires-python = ">=3.9"
+license = "MIT"
+authors = [{ name = "Dumont Pty Ltd", email = "sales@moveezi.com" }]
+keywords = ["moveezi", "moving", "relocation", "storage", "logistics", "api", "sdk", "mcp", "agent", "llm"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Topic :: Office/Business",
+  "Typing :: Typed",
+]
+dependencies = []
+
+[project.urls]
+Homepage = "https://www.moveezi.com/developers"
+Documentation = "https://www.moveezi.com/openapi.json"
+Repository = "https://github.com/DumontAI/moveezi-sdk"
+Issues = "https://github.com/DumontAI/moveezi-sdk/issues"
+
+[project.scripts]
+moveezi = "moveezi.__main__:main"
+
+[tool.setuptools.packages.find]
+include = ["moveezi*"]

moveezi-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+