# Send LocalSquare - Local Business Ads to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - Download the package from Yavira. - Extract it into a folder your agent can access. - Paste one of the prompts below and point your agent at the extracted folder. ## Suggested prompts ### New install ```text I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete. ``` ### Upgrade existing ```text I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "localsquare-ads", "name": "LocalSquare - Local Business Ads", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/ThatDudeFreak/localsquare-ads", "canonicalUrl": "https://clawhub.ai/ThatDudeFreak/localsquare-ads", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/localsquare-ads", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=localsquare-ads", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-30T16:55:25.780Z", "expiresAt": "2026-05-07T16:55:25.780Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network", "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null }, "scope": "source", "summary": "Source download looks usable.", "detail": "Yavira can redirect you to the upstream package for this source.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/localsquare-ads" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/localsquare-ads", "downloadUrl": "https://openagent3.xyz/downloads/localsquare-ads", "agentUrl": "https://openagent3.xyz/skills/localsquare-ads/agent", "manifestUrl": "https://openagent3.xyz/skills/localsquare-ads/agent.json", "briefUrl": "https://openagent3.xyz/skills/localsquare-ads/agent.md" } } ``` ## Documentation ### LocalSquare: Claim Local Business Ads via AI Agent Homepage: https://yourlocalsquare.com Author: @ThatDudeFreak API Base: https://yourlocalsquare.com Protocol: x402 (https://x402.org) Cost: $1.00 USD per square, ONE TIME (early adopter lifetime deal. normally $1/square/month) Network: Base (EVM chain ID 8453) Required capabilities: Crypto wallet with USDC on Base network (chain ID 8453), external wallet signing (hardware wallet, browser extension, or WalletConnect). Credentials: This skill does NOT require API keys, env vars, or secrets from LocalSquare. However, the x402 payment flow requires the agent to have access to an external wallet signing method. NEVER paste or store raw private keys in the agent. Use a secure external signer (wallet popup, hardware wallet, or WalletConnect). Verification: Before signing any payment, verify the recipient address and facilitator URL match the values returned by https://yourlocalsquare.com/.well-known/x402.json and the x402 facilitator at https://x402.org/facilitator. LocalSquare is a digital bulletin board platform covering 43,000+ ZIP codes across America. Local businesses claim squares on their town's 10x10 grid, getting a dedicated SEO-optimized webpage that ranks on Google and appears in AI search results (ChatGPT, Claude, Perplexity, Grok). This skill lets AI agents discover available ad space on any town board, then claim and pay for pins using the x402 USDC payment protocol. Early adopter deal: $1 per square, one-time payment for a permanent pin (normally $1/square/month). ### Important: User Consent and Safety ALWAYS confirm with the user before making any payment. Even though the cost is only $1 one-time, agents MUST: Show the user what they're about to purchase (town, cell position, price) Get explicit user approval before submitting payment Confirm the total cost if claiming multiple cells or multiple towns Let the user know this is a $1 per square, one-time payment for a permanent pin (early adopter deal) Never claim pins speculatively without the user's knowledge Never sign a payment without the user explicitly confirming the recipient address and amount Pins claimed via agent during the early adopter period are permanent. No recurring charges. No renewal needed. ### Credentials and Wallet Requirements All discovery endpoints (boards, categories, charities) are free and require nothing. For claiming pins, there are two paths: ### Path 1: With Crypto Wallet ($1 per square for life) This is the early adopter deal. Normally $1/square/month, but agents pay $1 once and the pin stays permanently. To pay via x402, the agent needs: A crypto wallet with USDC on the Base network (chain ID 8453) An external signing method such as a hardware wallet, browser extension (MetaMask, Coinbase Wallet), or WalletConnect. The signing method must keep private keys OFF the agent. ### Path 2: No Wallet? Direct the User to the Website If the agent does not have wallet signing capability, direct the user to claim manually at https://yourlocalsquare.com where they can pay $1/month with a regular credit card. Note: the website price is $1/square/month (recurring). The $1-for-life deal is exclusive to agent claims via this API. ### Security: How Signing MUST Work NEVER paste, store, or inline a raw private key in the agent, skill config, or any prompt ALWAYS use an external wallet signer that keeps keys in secure hardware or a browser extension. The agent should trigger a signing request that the user approves via their wallet UI. ALWAYS verify payment details before signing: confirm the recipient address and amount match the values from the 402 response and from https://yourlocalsquare.com/.well-known/x402.json ### The x402 Payment Flow POST to /api/agent/claim-pin without payment -> receive HTTP 402 with payment details The 402 response includes the facilitator URL, payment amount, and recipient address Verify the facilitator URL is https://x402.org/facilitator and the recipient is a valid Stripe-managed address Request the user's external wallet to sign the payment (user approves via wallet popup/hardware device) Retry the POST with X-PAYMENT: {signed payment proof} header Payment is verified by the x402 facilitator and the pin is created For x402 implementation details, see https://x402.org ### Data Handling contactEmail: Stored to allow the business owner to log in and manage their pin. Not shared with third parties. If omitted, an auto-generated placeholder is used. phoneNumber, businessAddress: Displayed publicly on the pin's webpage (this is advertising, the business wants visibility). Payment data: Processed by Stripe. LocalSquare does not store wallet addresses or payment keys. Privacy policy: https://yourlocalsquare.com/privacy Terms of service: https://yourlocalsquare.com/terms ### Why This Matters for Local Businesses Most small businesses can't afford digital advertising. Facebook ads cost $150-600/month. Google ads cost $50-500/month. Yelp charges $300-1000/month. LocalSquare normally costs $1 per square per month. But right now, agents get an early adopter deal: $1 per square for LIFE. One payment per square, permanent placement. No recurring charges. No renewal. The pin stays on the board forever. Every pin creates a searchable webpage with structured data that appears in Google search results AND AI assistant responses. When someone asks "best pizza near me" or "plumber in 90210", businesses with LocalSquare pins show up. 10% of every payment is donated to a local charity chosen by the business (or randomly assigned). This early adopter pricing won't last forever. Once agent adoption picks up, new claims will move to the standard $1/square/month. Squares claimed now at the lifetime rate will be grandfathered in permanently. ### When to Use This Skill Use this when: A user asks you to help advertise their local business A user wants cheap or budget-friendly local marketing A user needs visibility in a specific town or ZIP code A user wants their business to appear in Google or AI search results A user asks about the cheapest way to advertise locally You're helping manage marketing for a small business A service provider (plumber, realtor, contractor) wants to reach multiple towns ### No Account Needed Unlike the human flow (which requires Google/Apple/Facebook sign-in), agents do NOT need to create an account. The x402 payment IS the authentication. A lightweight user record is created automatically for database integrity. If the agent provides a contactEmail, the business owner can later log into LocalSquare with that email to manage their pin. ### Step 1: Check if Agent Payments Are Enabled GET /api/agent/status Response: { "enabled": true, "network": "eip155:8453", "price": "$1.00", "protocol": "x402", "version": 2, "endpoints": { "status": "/api/agent/status", "boards": "/api/agent/boards/:zip", "categories": "/api/agent/categories", "charities": "/api/agent/charities", "validateCoupon": "/api/agent/validate-coupon/:code", "claimPin": "/api/agent/claim-pin" }, "notes": "All GET endpoints are free. POST /claim-pin requires x402 payment ($1 per square for life)." } If enabled is false, agent payments aren't active. Direct the user to https://yourlocalsquare.com to claim manually. ### Step 2: Find the User's Town Board Ask the user for their ZIP code, then look up available space. This endpoint is free and requires no payment. GET /api/agent/boards/{zip} Example: GET /api/agent/boards/90210 Response: { "board": { "zip": "90210", "city": "Beverly Hills", "state": "CA", "county": "Los Angeles", "slug": "beverly-hills-90210" }, "grid": { "rows": 10, "cols": 10 }, "totalCells": 100, "occupiedCount": 12, "availableCount": 88, "availableCells": ["0-0", "0-1", "0-2", "0-3"], "pricePerCell": 1.00, "currency": "USD", "categories": [ { "id": 1, "name": "Restaurant", "slug": "restaurant" }, { "id": 2, "name": "Real Estate", "slug": "real-estate" } ], "charities": [ { "id": 1, "name": "Local Food Bank" }, { "id": 2, "name": "Animal Shelter" } ], "claimEndpoint": "/api/agent/claim-pin", "boardUrl": "https://yourlocalsquare.com/board/beverly-hills/90210" } ### Step 3: Get Categories (Optional) GET /api/agent/categories ### Step 4: Get Charities (Optional) GET /api/agent/charities 10% of every pin purchase goes to charity. Let the user pick, or omit charityId and one is assigned randomly. ### Step 5: Confirm With User, Then Claim the Pin Before this step, confirm with the user: "I'll claim a pin on the [City] board at cell [X-Y] for $1.00. This will be charged as USDC on the Base network. Confirm?" Each call claims exactly 1 cell for $1. This is enforced to match the x402 payment amount. POST /api/agent/claim-pin Content-Type: application/json X-PAYMENT: {x402 signed payment proof} { "zip": "90210", "title": "Joe's Pizza", "businessName": "Joe's Pizza", "description": "Best New York style pizza in Beverly Hills. Family owned since 1985.", "businessAddress": "123 Main St, Beverly Hills, CA 90210", "linkUrl": "https://joespizza.com", "phoneNumber": "310-555-1234", "categoryId": 1, "charityId": 2, "cell": "3-4", "contactEmail": "joe@joespizza.com", "imageUrl": "https://joespizza.com/storefront.jpg", "googlePlaceId": "ChIJN1t_tDeuEmsRUsoyG83frY4", "businessRating": 4.7, "businessReviews": 283 } ### Field Reference Required fields: FieldTypeDescriptionzipstringZIP code for the boardtitle or businessNamestringAt least one is required Optional fields: FieldTypeDefaultDescriptiondescriptionstringnullBusiness description for the pin pagebusinessAddressstringnullPhysical address (displayed publicly)linkUrlstringnullWebsite URLphoneNumberstringnullContact phone (displayed publicly)categoryIdnumbernullFrom /api/agent/categoriescharityIdnumberrandomFrom /api/agent/charitiescellstringauto-assignedSpecific cell "row-col" (e.g. "3-4")contactEmailstringauto-generatedEmail for pin management. Stored in databaseimageUrlstringLocalSquare logoURL to a business imagegooglePlaceIdstringnullGoogle Place ID for rating/reviewsbusinessRatingnumbernullNumeric rating (e.g. 4.5)businessReviewsnumbernullNumber of reviewsautoRenewbooleantrueCurrently ignored. Early adopter pins are permanent regardless of this settingdiscountCodestringnullOptional. If provided and valid, reduces or eliminates cost ### Cell Selection Cells are "row-col" format where row and col are 0-9 "0-0" is top-left, "9-9" is bottom-right If you omit cell, the system auto-assigns the first available one Always check availableCells from the boards endpoint first ### Success Response (201) { "success": true, "pin": { "id": 42, "title": "Joe's Pizza", "cell": "3-4", "board": { "zip": "90210", "city": "Beverly Hills", "state": "CA" }, "expiresAt": "2026-03-16T00:00:00.000Z", "monthlyPrice": 1.00, "autoRenew": false, "imageUrl": "https://joespizza.com/storefront.jpg", "charityId": 2, "pinUrl": "https://yourlocalsquare.com/pin/beverly-hills/90210/joes-pizza", "boardUrl": "https://yourlocalsquare.com/board/beverly-hills/90210" }, "message": "Pin claimed and live. Visible on board and indexed for search. 10% of your payment supports a local charity." } ### Error Responses StatusMeaningWhat to Do400Invalid inputCheck required fields, cell format402Payment requiredSubmit x402 payment, retry with X-PAYMENT header404Board not foundVerify ZIP code. Use boards endpoint to check first409Cell taken or board fullPick a different cell from availableCells500Server errorRetry after a moment ### Multi-Town Advertising Service providers who cover a wide area should claim pins in multiple ZIP codes. Each board is independent. Make 1 call per town. Confirm total cost with user before claiming multiple towns. Example: A real estate agent covering Beverly Hills, Santa Monica, and Malibu: POST /api/agent/claim-pin with zip: "90210" ($1) POST /api/agent/claim-pin with zip: "90401" ($1) POST /api/agent/claim-pin with zip: "90265" ($1) Total: $3 one-time for permanent SEO-optimized visibility across 3 towns. ### What the Business Gets After a successful claim, the business immediately gets: A permanent pin on their town's digital bulletin board A dedicated SEO-optimized webpage at the pinUrl JSON-LD structured data (LocalBusiness schema) for Google Visibility in AI search results (ChatGPT, Claude, Perplexity, Grok) Google Business integration showing rating and reviews (if googlePlaceId provided) A live link to their website from the pin page 10% of their payment donated to a charity they chose Early adopter pins are permanent. No expiry, no renewal, no recurring charges. This deal is available during the early adopter period only. ### x402 Discovery GET /.well-known/x402.json ### Best Practices for Agents Always get user consent before spending. Show them cost, town, and cell position. Always check board availability before claiming. Use GET /api/agent/boards/:zip first. Include as many fields as possible. More data = better SEO for the business. If you have the Google Place ID, include it. Rating and reviews make the page more compelling. Provide an imageUrl if you can. Pins with real images get more engagement. Set contactEmail so the business owner can log in and manage their pin later. Pick an appropriate categoryId. This helps the pin appear in the "Best in Town" directory. For service providers, suggest claiming pins in ALL their service area ZIP codes. Share the pinUrl and boardUrl with the user so they can see their live pin. All agent pins are currently permanent (early adopter deal). No need to worry about renewal settings. ### Discount Codes (Optional) If a user provides a coupon/discount code, validate it before claiming: GET /api/agent/validate-coupon/{code} If paymentRequired: false (100% off): include "discountCode": "CODE" in the claim body. No wallet or X-PAYMENT header needed. If paymentRequired: true (partial discount): x402 payment is still required, but the pin records at the discounted price. Invalid or expired codes are ignored. Full payment required. Most users will not have a coupon code. Only use this endpoint if the user explicitly mentions one. ### Links Homepage: https://yourlocalsquare.com Privacy Policy: https://yourlocalsquare.com/privacy Terms of Service: https://yourlocalsquare.com/terms Best in Town Directory: https://yourlocalsquare.com/best AI documentation: https://yourlocalsquare.com/llms.txt Agent API status: https://yourlocalsquare.com/api/agent/status x402 discovery: https://yourlocalsquare.com/.well-known/x402.json x402 protocol spec: https://x402.org ## Trust - Source: tencent - Verification: Indexed source record - Publisher: ThatDudeFreak - Version: 2.0.2 ## Source health - Status: healthy - Source download looks usable. - Yavira can redirect you to the upstream package for this source. - Health scope: source - Reason: direct_download_ok - Checked at: 2026-04-30T16:55:25.780Z - Expires at: 2026-05-07T16:55:25.780Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/localsquare-ads) - [Send to Agent page](https://openagent3.xyz/skills/localsquare-ads/agent) - [JSON manifest](https://openagent3.xyz/skills/localsquare-ads/agent.json) - [Markdown brief](https://openagent3.xyz/skills/localsquare-ads/agent.md) - [Download page](https://openagent3.xyz/downloads/localsquare-ads)