v0.1.3

Author: SebastianBitsch

CHANGELOG.md

@@ -7,6 +7,23 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.1.3] - 2026-01-30
+
+### Fixed
+- README example: Use correct field names (`.merchants` not `.results`, `.products` not `.results`)
+- Examples: Fixed and uncommented `ucp_search.py` with correct field names
+
+## [0.1.2] - 2026-01-30
+
+### Fixed
+- UCP merchant search endpoint: Changed from `/ucp/v1/merchants/search` to `/ucp/v1/merchants` to match API
+
+## [0.1.1] - 2026-01-30
+
+### Fixed
+- GitHub workflow: Made Codecov upload optional (no longer fails if token is missing)
+- GitHub workflow: Removed Python 3.9 from test matrix (package requires >=3.10)
+
 ## [0.1.0] - 2026-01-29
 
 Initial release.

README.md

@@ -33,7 +33,7 @@ async def main():
 
         # Search UCP merchants
         merchants = await client.ucp.merchants.search(industry="retail")
-        for merchant in merchants.results:
+        for merchant in merchants.merchants:
             print(f"{merchant.name}: {merchant.domain}")
 
 asyncio.run(main())

examples/ucp_search.py

@@ -9,8 +9,7 @@
 import asyncio
 import os
 
-# TODO: Uncomment after implementation
-# from rencom import AsyncRencomClient
+from rencom import AsyncRencomClient
 
 
 async def main():
@@ -20,42 +19,39 @@ async def main():
         print("Error: RENCOM_API_KEY environment variable not set")
         return
 
-    # TODO: Uncomment after implementation
-    # async with AsyncRencomClient(api_key=api_key) as client:
-    #     # Search for retail merchants with checkout capability
-    #     print("Searching for retail merchants...")
-    #     merchants = await client.ucp.merchants.search(
-    #         capabilities=["dev.ucp.shopping.checkout"],
-    #         industry="retail",
-    #         limit=5
-    #     )
-    #
-    #     print(f"\nFound {len(merchants.results)} merchants:")
-    #     for merchant in merchants.results:
-    #         print(f"\n{merchant.name} ({merchant.domain})")
-    #         print(f"  Industry: {merchant.industry}")
-    #         print(f"  Region: {merchant.region}")
-    #         print(f"  Capabilities: {', '.join(merchant.capabilities)}")
-    #
-    #     # Search for products
-    #     print("\n\nSearching for laptops under $1500...")
-    #     products = await client.ucp.products.search(
-    #         "laptop",
-    #         price_max=150000,  # $1500 in cents
-    #         category="electronics",
-    #         condition="new",
-    #         limit=10
-    #     )
-    #
-    #     print(f"\nFound {len(products.results)} products:")
-    #     for product in products.results:
-    #         price = product.price_cents / 100
-    #         print(f"\n{product.name}")
-    #         print(f"  Price: ${price:.2f}")
-    #         print(f"  Merchant: {product.merchant_domain}")
-    #         print(f"  Brand: {product.brand}")
-
-    print("TODO: Implement after client is ready")
+    async with AsyncRencomClient(api_key=api_key) as client:
+        # Search for retail merchants with checkout capability
+        print("Searching for retail merchants...")
+        merchants = await client.ucp.merchants.search(
+            capabilities=["dev.ucp.shopping.checkout"], industry="retail", limit=5
+        )
+
+        print(f"\nFound {merchants.total} merchants (showing {len(merchants.merchants)}):")
+        for merchant in merchants.merchants:
+            print(f"\n{merchant.name} ({merchant.domain})")
+            print(f"  Industry: {merchant.industry}")
+            print(f"  Region: {merchant.region}")
+            print(f"  Capabilities: {', '.join(merchant.capabilities)}")
+
+        # Search for products
+        print("\n\nSearching for laptops under $1500...")
+        products = await client.ucp.products.search(
+            "laptop",
+            price_max=150000,  # $1500 in cents
+            category="electronics",
+            condition="new",
+            limit=10,
+        )
+
+        print(f"\nFound {products.total} products (showing {len(products.products)}):")
+        for product in products.products:
+            if product.price:
+                price = product.price.amount / 100
+                print(f"\n{product.title}")
+                print(f"  Price: ${price:.2f}")
+                print(f"  Merchant: {product.merchant_domain}")
+                if product.brand:
+                    print(f"  Brand: {product.brand}")
 
 
 if __name__ == "__main__":

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "rencom"
-version = "0.1.0"
+version = "0.1.3"
 description = "Official Python SDK for the Rencom API - unified search for x402 resources and UCP merchants"
 readme = "README.md"
 requires-python = ">=3.10"

rencom/ucp/merchants.py

@@ -84,7 +84,7 @@ async def search(
             params["session_id"] = session_id
 
         # Make request
-        response_data = await self._http.get("/ucp/v1/merchants/search", params=params)
+        response_data = await self._http.get("/ucp/v1/merchants", params=params)
 
         # Parse response
         return MerchantSearchResponse.model_validate(response_data)

tests/unit/test_ucp.py

@@ -49,7 +49,7 @@ async def test_search_basic(self):
             "search_log_id": 456,
         }
 
-        respx.get("https://api.test.com/ucp/v1/merchants/search").mock(
+        respx.get("https://api.test.com/ucp/v1/merchants").mock(
             return_value=Response(200, json=response_data)
         )
 
@@ -77,7 +77,7 @@ async def test_search_with_filters(self):
             "search_log_id": 456,
         }
 
-        route = respx.get("https://api.test.com/ucp/v1/merchants/search").mock(
+        route = respx.get("https://api.test.com/ucp/v1/merchants").mock(
             return_value=Response(200, json=response_data)
         )
 
@@ -192,7 +192,7 @@ async def test_search_iter(self):
             "search_log_id": 456,
         }
 
-        route = respx.get("https://api.test.com/ucp/v1/merchants/search")
+        route = respx.get("https://api.test.com/ucp/v1/merchants")
         route.side_effect = [
             Response(200, json=page1),
             Response(200, json=page2),
@@ -435,7 +435,7 @@ async def test_namespace_via_main_client(self):
             "search_log_id": 456,
         }
 
-        respx.get("https://api.test.com/ucp/v1/merchants/search").mock(
+        respx.get("https://api.test.com/ucp/v1/merchants").mock(
             return_value=Response(200, json=response_data)
         )