A location-intelligent skill for finding bookshops, second-hand stores, and reading spaces near a user's current coordinates.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install bookshops
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install bookshops using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Nearby Bookshops?
Nearby Bookshops is a specialized tool designed for the Openclaw Skills ecosystem that enables AI agents to locate physical book retail locations and reading environments. It leverages geolocation data to provide users with a curated list of bookshops, ensuring that the results are relevant to their immediate physical context.
By unifying query behavior and response fields, this skill allows for seamless integration into frontend interfaces and API workflows. Whether a user is looking for a general bookstore, a niche second-hand shop, or a quiet space to read, this skill provides accurate Points of Interest (POI) data with customizable search parameters.
Nearby Bookshops Use Cases
- Finding the nearest bookstore while traveling or in an unfamiliar city.
- Locating specialized second-hand or used bookshops using keyword filters.
- Identifying reading spaces and library-adjacent environments within a specific radius.
- Integrating local book discovery into broader travel or productivity AI workflows.
How Nearby Bookshops Works
- The skill is triggered when a user provides a location-based intent, such as asking for bookshops near me.
- The system captures the mandatory latitude and longitude coordinates along with optional radius and limit parameters.
- The skill queries the underlying data provider using specified filters like keywords or opening hours.
- Data is processed to ensure privacy compliance, such as grid-based blurring or coordinate masking where necessary.
- A standardized POI list is returned following the defined response schema for immediate display or further processing.
Nearby Bookshops Setup
To integrate Nearby Bookshops into your environment, ensure you have the Openclaw Skills CLI installed and configure your location provider credentials.
# Install the skill via the Openclaw registry
openclaw install nearby-bookshops
# Configure your location provider API key
openclaw config set LOCATION_PROVIDER_KEY=your_api_key_here
Nearby Bookshops Data Schema & Taxonomy
The skill utilizes a structured input/output format to ensure consistency across the Openclaw Skills ecosystem.
| Parameter | Type | Description | Required |
|---|---|---|---|
| location | object | Coordinates containing { lat, lng } | Yes |
| radius_meters | integer | Search radius (default: 3000m) | No |
| limit | integer | Max results (default: 20, max: 50) | No |
| filters | object | Criteria like open_now, min_rating, or keywords | No |
All successful responses follow the STANDARD_RESPONSE.md format with the category field fixed as "bookshops".
Nearby Bookshops Advanced Features
- Intelligent caching: Implements short-term caching for identical location and radius queries to reduce latency and API costs.
- Privacy First: Supports grid-based coordinate blurring to protect user location precision.
- Advanced Filtering: Allows power users to narrow results by specific keywords (e.g., "rare books") or current operational status.
- Error Handling: Includes specific error codes like INVALID_LOCATION and RADIUS_TOO_LARGE for robust debugging.
SKILL.md
Loading
Related Openclaw Skills
Smarty
Smarty is a powerful integration skill for managing PHP templates and performing advanced address verification and CRM data operations through the Membrane ecosystem.
Retirecalc Beijing
A professional pension calculation and strategy optimization tool tailored specifically for enterprise employees and flexible workers in Beijing.
Room Makeover Video Generator
A specialized tool for generating high-quality vertical video shorts featuring dramatic home makeovers and aesthetic room transformations.
Retail Knowledge Q&A Engine
A specialized Q&A engine that provides retail digital employees with instant access to product details, store policies, and promotional information.
AI Upwork Job Auto-Apply System
A high-performance autonomous bidding agent that identifies qualified Upwork jobs and generates battle-tested proposals to maximize interview rates.
IPinfo.io
A comprehensive IP intelligence skill that provides real-time geolocation, ASN, and organizational data for any IP address.
Featured*
