# Send Amadeus Hotels 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "amadeus-hotels",
    "name": "Amadeus Hotels",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/kesslerio/amadeus-hotels",
    "canonicalUrl": "https://clawhub.ai/kesslerio/amadeus-hotels",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/amadeus-hotels",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=amadeus-hotels",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "references/amenities.md",
      "scripts/auth.py",
      "scripts/details.py",
      "scripts/offers.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/amadeus-hotels"
    },
    "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/amadeus-hotels",
    "downloadUrl": "https://openagent3.xyz/downloads/amadeus-hotels",
    "agentUrl": "https://openagent3.xyz/skills/amadeus-hotels/agent",
    "manifestUrl": "https://openagent3.xyz/skills/amadeus-hotels/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/amadeus-hotels/agent.md"
  }
}
```
## Documentation

### Amadeus Hotels Skill 🏨

Search hotel prices, availability, and ratings via the Amadeus Self-Service API. Perfect for vacation planning and deal hunting.

### Setup

Get API credentials at https://developers.amadeus.com/self-service

Create account → My Apps → Create new app
Copy API Key and API Secret



Set environment variables:

export AMADEUS_API_KEY="your-api-key"
export AMADEUS_API_SECRET="your-api-secret"
export AMADEUS_ENV="test"  # or "production" for real bookings

Install dependency:

pip install requests

Free tier: ~2,000 requests/month in test, pay-per-use after in production.

### Quick Reference

TaskScriptExampleSearch by cityscripts/search.py--city PAR --checkin 2026-03-15 --checkout 2026-03-20Get offersscripts/offers.py--hotels HTPAR123,HTPAR456 --adults 2Offer detailsscripts/details.py--offer-id ABC123Track pricescripts/track.py--add --hotel HTPAR123 --target 150Check trackedscripts/track.py--check

### 1. Hotel Search

Find hotels by city code (IATA) or coordinates:

# By city
python3 <skill>/scripts/search.py --city PAR --checkin 2026-03-15 --checkout 2026-03-20

# By coordinates (near a landmark)
python3 <skill>/scripts/search.py --lat 48.8584 --lon 2.2945 --radius 5 --checkin 2026-03-15 --checkout 2026-03-20

# With filters
python3 <skill>/scripts/search.py --city NYC --amenities WIFI,POOL,SPA --ratings 4,5

Common city codes: PAR (Paris), NYC (New York), TYO (Tokyo), BCN (Barcelona), LON (London), LAX (Los Angeles), SFO (San Francisco)

### 2. Get Pricing & Availability

Once you have hotel IDs from search:

python3 <skill>/scripts/offers.py \\
  --hotels HTPAR001,HTPAR002 \\
  --checkin 2026-03-15 \\
  --checkout 2026-03-20 \\
  --adults 2 \\
  --rooms 1

Returns: Room types, prices, cancellation policies, board types.

### 3. Offer Details

Get full details for a specific offer before booking:

python3 <skill>/scripts/details.py --offer-id <offer-id-from-search>

Returns: Detailed room info, full cancellation policy, payment terms, hotel contact.

### 4. Hotel Ratings & Sentiment

Get aggregated review sentiment:

python3 <skill>/scripts/details.py --hotel-id HTPAR001 --ratings

Returns: Overall score (0-100), category scores (Staff, Location, WiFi, Cleanliness, etc.)

### 5. Price Tracking

Track hotels and get alerts when prices drop:

# Add hotel to tracking
python3 <skill>/scripts/track.py --add \\
  --hotel HTPAR001 \\
  --checkin 2026-03-15 \\
  --checkout 2026-03-20 \\
  --adults 2 \\
  --target 150  # Alert if price drops below $150/night

# Check all tracked hotels (run via cron)
python3 <skill>/scripts/track.py --check

# List tracked hotels
python3 <skill>/scripts/track.py --list

# Remove from tracking
python3 <skill>/scripts/track.py --remove --hotel HTPAR001

### Cron Setup for Price Alerts

Add to OpenClaw cron for automatic price monitoring:

# Check hotel prices twice daily
- schedule: "0 9,18 * * *"
  task: "Run hotel price tracker and alert on drops"
  command: "python3 <skill>/scripts/track.py --check"

When prices drop below target, the script outputs alert text. Configure your notification channel in the cron task.

### Output Formatting

Scripts output JSON by default. Add --format human for readable output:

python3 <skill>/scripts/search.py --city PAR --format human

Human format example:

🏨 Hotel & Spa Paris Marais ★★★★
   📍 15 Rue du Temple, Paris
   💰 €189/night (was €220)
   ✨ WIFI, SPA, RESTAURANT
   📊 Rating: 87/100 (Staff: 92, Location: 95)

### Amenity Codes

Common filters for --amenities:

CodeMeaningWIFIFree WiFiPOOLSwimming poolSPASpa/wellnessGYMFitness centerRESTAURANTOn-site restaurantPARKINGParking availablePETS_ALLOWEDPet-friendlyAIR_CONDITIONINGA/CKITCHENKitchen/kitchenette

Full list in references/amenities.md.

### ⚠️ Important: Pricing Disclaimer

Amadeus API prices are NOT retail prices. The API returns negotiated, net, or wholesale rates — not the public prices you see on Booking.com, Expedia, or hotel websites.

Key differences:

Net vs Retail: API returns "net rates" (raw cost), not marked-up retail prices
B2B Pricing: Designed for travel agencies/developers to add their own markup
Negotiated Rates: May include corporate or consortia rates unavailable to consumers
Tax Breakdown: Prices often show base + taxes separately

Use these prices for comparison and tracking trends, not as exact retail quotes. Actual booking prices on consumer sites will differ.

### Limitations & Notes

Test environment: Limited/cached data, not real-time. Good for development.
Production: Real prices but requires "Move to Production" in Amadeus dashboard.
No direct booking: API returns offer details; actual booking requires payment handling (PCI compliance).
Rate limits: 10 TPS (test), 40 TPS (production). Scripts include backoff.
Data freshness: Prices change frequently. Always re-check before booking elsewhere.
Not retail prices: See pricing disclaimer above.

### Error Handling

ErrorMeaningAction401Auth failedCheck API key/secret429Rate limitedWait and retry (auto-handled)400Bad requestCheck parameters (dates, codes)No resultsNo availabilityTry different dates or expand search

### References

references/amenities.md — Full amenity code list
https://developers.amadeus.com/self-service/apis-docs — Official API docs
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: kesslerio
- Version: 1.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-23T16:43:11.935Z
- Expires at: 2026-04-30T16:43:11.935Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/amadeus-hotels)
- [Send to Agent page](https://openagent3.xyz/skills/amadeus-hotels/agent)
- [JSON manifest](https://openagent3.xyz/skills/amadeus-hotels/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/amadeus-hotels/agent.md)
- [Download page](https://openagent3.xyz/downloads/amadeus-hotels)