ai-local-places

ai-local-places Local Places Recommendation Assistant

Quick Start

More Skills

Overview

The Local Places Recommendation Assistant is used to answer "where is a suitable place nearby," organize materials, clean data, and produce action items. It is suitable for operations, product, sales, and software to call after clarifying business goals, content materials, or analysis targets. It combines place needs or candidate lists, pasted place needs, candidate lists, budget, travel range, preference conditions, or review excerpts, and other inputs to organize key context, and outputs business diagnostics, local marketing suggestions, and execution checklists for continued execution, review, or delivery.

When to Use

Applicable Scenarios

• The user raises questions such as "where is a suitable place nearby" and needs to quickly break down goals, identify priorities, and form executable results
• Operations, product, sales, and software need to generate business diagnostics, local marketing suggestions, and execution checklists around the Local Places Recommendation Assistant
• The user has already prepared filtering goals (explaining the recommendation, comparison, route, budget, risk verification, or final decision to be completed), travel or usage targets (explaining the number of people, roles, preferences, scenarios, transportation methods, or activity types), and place or map links (filling in publicly accessible map, store, place, review, or candidate page links), and hopes to organize them into executable analysis or optimization results
• The user needs to turn materials related to the Local Places Recommendation Assistant into clear conclusions, priorities, and next actions

How to Call

Call the AI Skills API directly through the exported Python runner:

Command Examples

Basic Call

python3 scripts/run.py --params '{}'

Call with Common Parameters

python3 scripts/run.py --params '{"goal":"筛选目标"}'

Parameter Description

Parameter	Type	Required	Default	Description
goal	string	No	-	Explain the recommendation, comparison, route, budget, risk verification, or final decision to be completed
audience	string	No	-	Explain the number of people, roles, preferences, scenarios, transportation methods, or activity types
materialUrl	string	No	-	Fill in publicly accessible map, store, place, review, or candidate page links; a full accessible URL must be provided
materialFile	string	No	-	Upload place lists, review tables, activity requirements, budget tables, or research materials
materialText	string	No	-	Paste place needs, candidate lists, budget, travel range, preference conditions, or review excerpts
brandRequirements	string	No	-	Supplement time range, budget cap, distance limits, business requirements, pitfall avoidance conditions, or key points for manual verification

For the complete machine-readable parameter structure, see references/form-schema.json。

Parameter Value Reference

This skill currently has no categorical parameters that require additional lookup.

Supported Input Formats

This skill directly accepts JSON parameters; if the parameters contain link fields, provide full, accessible URLs.

Example Request

The example parameters below can be passed directly to scripts/run.py, and the runner will send them to the AI Skills API.

python3 scripts/run.py --params '{"goal":"筛选目标"}'

Equivalent --params JSON：

{
  "goal": "筛选目标"
}

Example of returned results

{
  "success": true,
  "data": {
    "message": "示例结果请以技能真实返回结构为准。"
  },
  "meta": {
    "executionTime": 842,
    "cached": false
  }
}

Deliverables

• Business diagnosis, local marketing suggestions, and execution checklist: organize the core results around the user's goals so they can be directly read, reviewed, or delivered.
• Interpretation of input materials: combine the screening objective (state the recommendation, comparison, route, budget, risk verification, or final decision to be completed.), travel or usage participants (state the number of people, roles, preferences, scenarios, transportation methods, or activity types.), and location or map link (fill in publicly accessible links to maps, stores, locations, reviews, or candidate pages.) to extract key context and the basis for judgment.
• Next steps: provide priorities, execution suggestions, or a content framework that can be further developed.

Suggestions for using the results

• First determine whether the output answers the user's core question about the "Local Place Recommendation Assistant".
• Then check whether the results cover the business diagnosis, local marketing suggestions, and execution checklist, and whether they provide clear next steps.
• If the input materials are limited, it is recommended to have the user supplement the goals, audience, constraints, or original materials before running.

Preparation before running

• AISKILLS_BASE_URL: default https://ai-skills.ai
• AISKILLS_API_KEY: required, used for authenticated calls
• AISKILLS_TENANT_ID: default default