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

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:

Complete the Browser Automation Setup using CDP mode
Login to the service manually in the Playwright-controlled Chrome window
Claude will use your authenticated session without ever seeing your password

如果你不想与Claude Code共享凭据：

使用CDP模式完成浏览器自动化设置
在Playwright控制的Chrome窗口中手动登录该服务
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

认证流程

Navigate to etsy.com via Playwright MCP
Click Sign In
Enter email from canifi-env
Enter password
Handle 2FA if enabled (notify user via iMessage)
Verify account access
Maintain session cookies

通过Playwright MCP导航到etsy.com
点击“登录”
输入canifi-env中的邮箱
输入密码
若启用了双因素认证（2FA），则处理验证（通过iMessage通知用户）
验证账户访问权限
维护会话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:

Document new UI elements
Add support for new item types
Log successful search patterns
Update for Etsy changes

当遇到Etsy新功能时：

记录新的UI元素
添加对新商品类型的支持
记录成功的搜索模式
根据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主打手工/复古商品
处理时间因卖家而异
定制订单可能耗时更长
店铺评价反映可靠性
运费差异较大
星级卖家徽章代表优质店铺
通常提供礼品包装服务