← Back to Skills Marketplace
134
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install bookshops
Description
Find nearby bookshops. Invoke when user asks for bookstores near me.
README (SKILL.md)
Nearby Bookshops
用途
- 提供用户当前位置附近的 Bookshops 列表
- 统一返回字段与查询行为，便于前端/接口复用
- 适用于找书店、二手书、阅读空间等场景
触发条件
- 用户询问“Bookshops 附近 / bookstore near me / nearby bookshops”
- 用户提供定位/城市并希望“找/推荐/看看附近的 Bookshops”
输入参数
- location: 经纬度 { lat, lng }，必填
- radius_meters: 查询半径，默认 3000
- limit: 返回数量上限，默认 20，最大 50
- filters: 可选筛选（open_now、min_rating、keywords 等）
响应字段
- 统一参见 STANDARD_RESPONSE.md
- 本技能 category 固定为 "bookshops"
错误码
- INVALID_LOCATION: 经纬度不合法
- RADIUS_TOO_LARGE: 超过最大查询半径
- PROVIDER_UNAVAILABLE: 数据源不可用
- RATE_LIMITED: 触发速率限制
示例
- 输入: { location: { lat: 30.123, lng: 120.456 }, radius_meters: 2500, limit: 10, filters: { keywords: "used" } }
- 输出: 标准 POI 列表（见 STANDARD_RESPONSE.md）
隐私与速率限制
- 仅在用户授权定位后查询
- 避免保留精确坐标，必要时进行网格化模糊处理
- 建议对同一 location+category+radius 做短时缓存以降低频率
Usage Guidance
This skill is small and coherent: it only needs the user's location to find nearby bookshops. Before installing, confirm how it will be implemented in your environment — specifically, which POI/data provider will be used and whether that provider requires API keys or will receive raw coordinates. Ensure the implementation enforces user consent, limits retention of precise coordinates (or applies the suggested fuzzing), and stores any provider credentials securely. If future versions add an install step or request environment variables, re-evaluate for disproportionate access.
Capability Assessment
Purpose & Capability
Name/description match the content of SKILL.md: it is explicitly about finding nearby bookshops and declares required inputs (location, radius, limit, filters). There are no unrelated environment variables, binaries, or config paths.
Instruction Scope
SKILL.md stays within scope (takes location, returns POI list, describes errors and privacy guidance). It does not specify which data provider or external API to call — this is not dangerous but leaves implementation details open; an implementation would likely need a POI provider and associated credentials.
Install Mechanism
No install spec and no code files (instruction-only). Nothing is written to disk or fetched at install time, minimizing risk.
Credentials
The skill declares no required environment variables or credentials. The inputs (user location) are appropriate for the stated purpose; the SKILL.md also recommends consent and coordinate fuzzing, which is proportionate.
Persistence & Privilege
always is false and there are no requests to modify system or other skills' configs. Nothing requests elevated or persistent privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install bookshops - After installation, invoke the skill by name or use
/bookshops - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Nearby Bookshops 0.1.0 – Initial Release
- Find nearby bookshops based on user location.
- Supports filters such as open_now, min_rating, and keywords.
- Returns standardized POI lists; enforces response consistency.
- Handles errors for invalid location, large radius, unavailable provider, and rate limits.
- Includes privacy safeguards and recommends caching frequent queries.
Metadata
Frequently Asked Questions
What is Nearby Bookshops?
Find nearby bookshops. Invoke when user asks for bookstores near me. It is an AI Agent Skill for Claude Code / OpenClaw, with 134 downloads so far.
How do I install Nearby Bookshops?
Run "/install bookshops" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Nearby Bookshops free?
Yes, Nearby Bookshops is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Nearby Bookshops support?
Nearby Bookshops is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Nearby Bookshops?
It is built and maintained by clawkk (@clawkk); the current version is v0.1.0.
More Skills