Back to Details

etsy

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Etsy Skill

Etsy 技能

Overview

概述

Automates Etsy operations including searching handmade and vintage items, managing favorites, and exploring shops through browser automation. Note: Actual purchases are not automated for security.
通过浏览器自动化实现Etsy操作自动化，包括搜索手工和复古商品、管理收藏以及探索店铺。注意：出于安全考虑，不支持实际购买操作。

Quick Install

快速安装

bash
curl -sSL https://canifi.com/skills/etsy/install.sh | bash
Or manually:
bash
cp -r skills/etsy ~/.canifi/skills/
bash
curl -sSL https://canifi.com/skills/etsy/install.sh | bash
或者手动安装：
bash
cp -r skills/etsy ~/.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 ETSY_EMAIL "your-email@example.com" canifi-env set ETSY_PASSWORD "your-password"
undefined
canifi-env set ETSY_EMAIL "your-email@example.com" canifi-env set ETSY_PASSWORD "your-password"
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 handmade and vintage items
  • Add items to favorites
  • Explore seller shops
  • Track order status
  • Browse categories
  • Read reviews
  • Save favorite shops
  • Compare similar items
  • 搜索手工和复古商品
  • 将商品添加到收藏
  • 探索卖家店铺
  • 跟踪订单状态
  • 浏览商品分类
  • 查看评价
  • 收藏店铺
  • 对比相似商品

Usage Examples

使用示例

Example 1: Search Products

示例1：搜索商品

User: "Find handmade leather wallets on Etsy"
Claude: I'll search for those wallets.
- Navigate to etsy.com
- Search "handmade leather wallet"
- Filter by handmade/custom
- Sort by reviews
- Present top options
用户：“在Etsy上找手工皮革钱包”
Claude：我会帮你搜索这些钱包。
- 导航到etsy.com
- 搜索“handmade leather wallet”
- 筛选手工/定制商品
- 按评价排序
- 展示热门选项

Example 2: Add to Favorites

示例2：添加到收藏

User: "Save this item to my Etsy favorites"
Claude: I'll add that to favorites.
- Navigate to item page
- Click heart/favorite button
- Confirm added to favorites
用户：“把这个商品保存到我的Etsy收藏”
Claude：我会帮你添加到收藏。
- 导航到商品页面
- 点击心形/收藏按钮
- 确认已添加到收藏

Example 3: Explore Shop

示例3：探索店铺

User: "Show me more items from this Etsy shop"
Claude: I'll explore their shop.
- Navigate to seller's shop
- Browse available items
- Note shop policies
- Present popular items
用户：“展示这家Etsy店铺的更多商品”
Claude：我会帮你探索这家店铺。
- 导航到卖家店铺
- 浏览在售商品
- 记录店铺政策
- 展示热门商品

Example 4: Track Order

示例4：跟踪订单

User: "Check my Etsy order status"
Claude: I'll check your orders.
- Navigate to Purchases
- Find recent order
- Check shipping status
- Report estimated delivery
用户：“查看我的Etsy订单状态”
Claude：我会帮你查看订单。
- 导航到“我的购买”页面
- 找到最近的订单
- 查看物流状态
- 报告预计送达时间

Authentication Flow

认证流程

  1. Navigate to etsy.com via Playwright MCP
  2. Click Sign In
  3. Enter email from canifi-env
  4. Enter password
  5. Handle 2FA if enabled (notify user via iMessage)
  6. Verify account access
  7. Maintain session cookies
  1. 通过Playwright MCP导航到etsy.com
  2. 点击“登录”
  3. 输入canifi-env中的邮箱
  4. 输入密码
  5. 若启用了双因素认证（2FA），则处理验证（通过iMessage通知用户）
  6. 验证账户访问权限
  7. 维护会话Cookie

Error Handling

错误处理

  • Login Failed: Clear cookies, verify credentials
  • Session Expired: Re-authenticate automatically
  • 2FA Required: iMessage for verification code
  • Item Unavailable: May be sold out
  • Shop Closed: Check shop vacation status
  • Processing Time: Note custom item delays
  • Favorites Full: Check list limits
  • Shipping Unavailable: Check seller location
  • 登录失败：清除Cookie，验证凭据
  • 会话过期：自动重新认证
  • 需要2FA：通过iMessage发送验证码
  • 商品不可用：可能已售罄
  • 店铺关闭：检查店铺休假状态
  • 处理时间：注意定制商品的延迟
  • 收藏已满：检查列表限制
  • 无法配送：检查卖家所在地

Self-Improvement Instructions

自我改进说明

When encountering new Etsy features:
  1. Document new UI elements
  2. Add support for new item types
  3. Log successful search patterns
  4. Update for Etsy changes
当遇到Etsy新功能时：
  1. 记录新的UI元素
  2. 添加对新商品类型的支持
  3. 记录成功的搜索模式
  4. 根据Etsy的更新进行适配

Notes

注意事项

  • Etsy specializes in handmade/vintage
  • Processing times vary by seller
  • Custom orders may take longer
  • Shop reviews indicate reliability
  • Shipping costs vary significantly
  • Star Seller badge for top shops
  • Gift wrapping often available
  • Etsy主打手工/复古商品
  • 处理时间因卖家而异
  • 定制订单可能耗时更长
  • 店铺评价反映可靠性
  • 运费差异较大
  • 星级卖家徽章代表优质店铺
  • 通常提供礼品包装服务