Back to Details

american-airlines

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

American Airlines Skill

美国航空Skill

Overview

概述

Enables Claude to search and book American Airlines flights, manage AAdvantage account, track Loyalty Points status, access oneworld partner benefits, and handle travel arrangements.
让Claude能够搜索并预订美国航空航班、管理AAdvantage账户、追踪Loyalty Points状态、使用oneworld合作伙伴权益，以及处理旅行安排。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/american-airlines/install.sh | bash
Or manually:
bash
cp -r skills/american-airlines ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/american-airlines/install.sh | bash
或者手动安装：
bash
cp -r skills/american-airlines ~/.canifi/skills/

Setup

设置

Configure via canifi-env:
bash
undefined
通过canifi-env进行配置：
bash
undefined

First, ensure canifi-env is installed:

首先，确保已安装canifi-env：

curl -sSL https://canifi.com/install.sh | bash

curl -sSL https://canifi.com/install.sh | bash

canifi-env set AA_EMAIL "your-email@example.com" canifi-env set AA_AADVANTAGE "your-aadvantage-number"
undefined
canifi-env set AA_EMAIL "your-email@example.com" canifi-env set AA_AADVANTAGE "your-aadvantage-number"
undefined

Privacy & Authentication

隐私与认证

Your credentials, your choice. Canifi LifeOS respects your privacy.
你的凭据，你来选择。 Canifi LifeOS尊重你的隐私。

Option 1: Manual Browser Login (Recommended)

选项1：手动浏览器登录（推荐）

If you prefer not to share credentials with Claude Code:
  1. Complete the Browser Automation Setup using CDP mode
  2. Login to the service manually in the Playwright-controlled Chrome window
  3. Claude will use your authenticated session without ever seeing your password
如果你不想与Claude Code共享凭据：
  1. 使用CDP模式完成浏览器自动化设置
  2. 在Playwright控制的Chrome窗口中手动登录服务
  3. Claude将使用你的已认证会话，全程不会获取你的密码

Option 2: Environment Variables

选项2：环境变量

If you're comfortable sharing credentials, you can store them locally:
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
Note: Credentials stored in canifi-env are only accessible locally on your machine and are never transmitted.
如果你愿意共享凭据，可以将其存储在本地：
bash
canifi-env set SERVICE_EMAIL "your-email"
canifi-env set SERVICE_PASSWORD "your-password"
注意：存储在canifi-env中的凭据仅能在你的本地设备访问，绝不会被传输。

Capabilities

功能特性

  • Search and book American and oneworld partner flights
  • Manage AAdvantage miles and Loyalty Points status
  • Select seats and request upgrades
  • Check real-time flight status and rebooking
  • Access Admiral's Club and Flagship Lounge info
  • Book award travel using miles
  • 搜索并预订美国航空及oneworld合作伙伴航班
  • 管理AAdvantage里程与Loyalty Points状态
  • 选座及申请升舱
  • 查询实时航班状态及重新预订
  • 获取Admiral's Club与Flagship Lounge相关信息
  • 使用里程预订奖励航班

Usage Examples

使用示例

Example 1: Search Flights

示例1：搜索航班

User: "Find American flights from Miami to New York tomorrow morning"
Claude: I'll search American for morning flights.
- Opens aa.com via Playwright MCP
- Enters MIA to JFK/LGA/EWR, tomorrow
- Filters: Departure before noon
- Shows options:
  - AA 1234 6:15am MIA-JFK: $189 Main
  - AA 5678 8:00am MIA-LGA: $215 Main Extra
  - AA 9012 10:30am MIA-JFK: $245 First available
- Notes: Earning 1,200 Loyalty Points
用户："帮我找明天早上从迈阿密到纽约的美国航空航班"
Claude：我将为你搜索美国航空的早间航班。
- 通过Playwright MCP打开aa.com
- 输入出发地MIA，目的地JFK/LGA/EWR，日期为明天
- 筛选条件：中午前起飞
- 展示可选航班：
  - AA 1234 早上6:15 MIA-JFK：经济舱（Main）189美元
  - AA 5678 早上8:00 MIA-LGA：优选经济舱（Main Extra）215美元
  - AA 9012 早上10:30 MIA-JFK：头等舱（First）可选，245美元
- 备注：可赚取1200点Loyalty Points

Example 2: Check Status Progress

示例2：查询状态进度

User: "What's my AAdvantage status and how close am I to the next level?"
Claude: I'll check your AAdvantage account.
- Logs into AAdvantage account
- Navigates to status dashboard
- Returns: Gold status
- Loyalty Points: 42,500 of 75,000 for Platinum
- Loyalty Choice Rewards: 1 remaining
- Miles balance: 89,432 available
- Status valid through: January 2026
用户："我的AAdvantage会员等级是什么？距离下一等级还差多少？"
Claude：我将为你查询AAdvantage账户信息。
- 登录AAdvantage账户
- 进入状态仪表盘
- 返回结果：黄金会员（Gold）等级
- Loyalty Points：已累积42,500点，距离白金会员（Platinum）需75,000点
- 忠诚度选择奖励（Loyalty Choice Rewards）：剩余1次
- 里程余额：89,432可用里程
- 会员等级有效期至：2026年1月

Example 3: Book Award Flight

示例3：预订奖励航班

User: "Can I book a flight to London with my American miles?"
Claude: I'll search for award availability.
- Searches award calendar MIA-LHR
- Shows saver awards available:
  - March 15: 30,000 miles + $45 taxes (Economy)
  - March 15: 57,500 miles (Business on BA)
- Anytime awards: 65,000 miles Economy
- Notes: oneworld partners may have better availability
- Recommends booking saver if dates flexible
用户："我能用美国航空里程预订去伦敦的航班吗？"
Claude：我将为你查询奖励航班的可用情况。
- 搜索MIA至LHR的奖励航班日历
- 展示特惠奖励航班（saver awards）可用情况：
  - 3月15日：30,000里程 + 45美元税费（经济舱）
  - 3月15日：57,500里程（英航商务舱）
- 任意日期奖励航班（Anytime awards）：经济舱65,000里程
- 备注：oneworld合作伙伴可能有更多可用航班
- 建议：若日期灵活，优先选择特惠奖励航班

Authentication Flow

认证流程

  1. Navigate to aa.com via Playwright MCP
  2. Click "Log in" and enter AAdvantage number
  3. Enter password
  4. Handle security verification if prompted
  5. Verify status badge displayed
  6. Maintain session for bookings
  1. 通过Playwright MCP导航至aa.com
  2. 点击“登录”并输入AAdvantage会员号
  3. 输入密码
  4. 若出现安全验证则完成验证流程
  5. 确认会员等级标识已显示
  6. 保持会话状态以进行预订操作

Error Handling

错误处理

  • Login Failed: Retry, check for account security holds
  • Award Not Available: Search alternate dates/partners
  • Upgrade Waitlisted: Monitor and alert when clears
  • Session Expired: Re-authenticate automatically
  • Rate Limited: Wait 60 seconds, retry
  • 2FA Required: Complete verification flow
  • 登录失败：重试，检查账户是否存在安全限制
  • 奖励航班不可用：搜索其他日期/合作伙伴航班
  • 升舱候补：持续监控并在候补成功时发出提醒
  • 会话过期：自动重新认证
  • 请求受限：等待60秒后重试
  • 需要2FA：完成验证流程

Self-Improvement Instructions

自我优化说明

After each interaction:
  • Track award availability patterns
  • Note upgrade clearing rates
  • Log status qualification rates
  • Document selector changes
Suggest updates when:
  • American updates booking interface
  • AAdvantage program changes
  • Award chart modifications
  • Partner availability changes
每次交互后：
  • 记录奖励航班可用模式
  • 记录升舱成功概率
  • 记录会员等级达标率
  • 记录页面选择器变更
在以下情况时建议更新：
  • 美国航空更新预订界面
  • AAdvantage会员计划变更
  • 奖励里程表调整
  • 合作伙伴航班可用情况变更

Notes

注意事项

  • AAdvantage status now based on Loyalty Points (not miles)
  • Systemwide Upgrades for Executive Platinum
  • Basic Economy cannot select seats or earn full miles
  • oneworld partners: BA, Qantas, Cathay, JAL, etc.
  • Flagship First/Business on premium international routes
  • Admiral's Club access varies by status and fare
  • AAdvantage会员等级现在基于Loyalty Points（而非里程）评定
  • 行政白金会员（Executive Platinum）可使用全航线升舱（Systemwide Upgrades）
  • 基础经济舱（Basic Economy）无法选座或累积全额里程
  • oneworld合作伙伴包括：英航（BA）、澳航（Qantas）、国泰航空（Cathay）、日航（JAL）等
  • 国际 premium 航线提供Flagship First/Business舱位
  • Admiral's Club休息室准入权限因会员等级和舱位而异