pocket

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Pocket Skill

Pocket Skill

Save and organize articles, videos, and web content for later reading with Pocket's read-it-later service.
借助Pocket的稍后阅读服务,保存并整理文章、视频和网页内容,供日后阅读。

Quick Install

快速安装

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

Setup

配置

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

First, ensure canifi-env is installed:

首先,确保已安装canifi-env:

canifi-env set POCKET_CONSUMER_KEY "your_consumer_key" canifi-env set POCKET_ACCESS_TOKEN "your_access_token"
undefined
canifi-env set POCKET_CONSUMER_KEY "your_consumer_key" canifi-env set POCKET_ACCESS_TOKEN "your_access_token"
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

功能特性

  1. Save Content: Save articles, videos, and web pages to your Pocket library for offline reading
  2. Organize Library: Tag, archive, and favorite saved items for easy organization and retrieval
  3. Search & Retrieve: Search your saved content by title, URL, or tags to find specific items
  4. Reading Progress: Track reading progress and get personalized recommendations based on interests
  5. Export & Share: Share saved articles to social media or export reading lists
  1. 保存内容:将文章、视频和网页保存到您的Pocket图书馆,以便离线阅读
  2. 整理图书馆:为已保存的内容添加标签、归档和标记收藏,方便整理和检索
  3. 搜索与检索:按标题、URL或标签搜索已保存的内容,查找特定项目
  4. 阅读进度追踪:追踪阅读进度,并根据兴趣获取个性化推荐
  5. 导出与分享:将已保存的文章分享到社交媒体,或导出阅读列表

Usage Examples

使用示例

Save an Article

保存文章

User: "Save this article to Pocket: https://example.com/interesting-article"
Assistant: Saves article to Pocket library with automatic metadata extraction
用户:"将这篇文章保存到Pocket:https://example.com/interesting-article"
助手:将文章保存到Pocket图书馆,并自动提取元数据

Organize with Tags

使用标签整理

User: "Tag my recent Pocket saves with 'AI research'"
Assistant: Applies 'AI research' tag to recently saved items
用户:"为我最近保存到Pocket的内容添加'AI research'标签"
助手:为最近保存的项目应用'AI research'标签

Search Library

搜索图书馆

User: "Find all my saved articles about machine learning"
Assistant: Searches Pocket library and returns matching items with titles and URLs
用户:"查找我所有关于机器学习的已保存文章"
助手:搜索Pocket图书馆,并返回匹配的项目及其标题和URL

Get Reading List

获取阅读列表

User: "Show me my unread Pocket articles from this week"
Assistant: Retrieves unread items saved in the last 7 days
用户:"显示我本周未读的Pocket文章"
助手:检索过去7天内保存的未读项目

Authentication Flow

认证流程

  1. Register application at getpocket.com/developer
  2. Obtain consumer key from developer portal
  3. Complete OAuth flow to get access token
  4. Store credentials securely in environment variables
  1. 在getpocket.com/developer注册应用
  2. 从开发者门户获取consumer key
  3. 完成OAuth流程以获取access token
  4. 将凭据安全存储在环境变量中

Error Handling

错误处理

ErrorCauseSolution
401 UnauthorizedInvalid or expired tokenRe-authenticate with OAuth flow
403 ForbiddenRate limit exceededWait and retry with exponential backoff
404 Not FoundItem doesn't existVerify item ID before operations
503 Service UnavailablePocket API downRetry after service restoration
错误原因解决方案
401 Unauthorized令牌无效或已过期通过OAuth流程重新认证
403 Forbidden超出速率限制等待后重试,使用指数退避策略
404 Not Found项目不存在操作前验证项目ID
503 Service UnavailablePocket API故障服务恢复后重试

Notes

注意事项

  • Free tier includes unlimited saves with basic features
  • Premium tier adds permanent library backup and full-text search
  • API rate limits apply: 10,000 requests per day
  • Offline reading requires mobile app download
  • Content is cached for 30 days in free tier
  • 免费版包含无限次保存和基础功能
  • 高级版添加永久图书馆备份和全文搜索功能
  • API速率限制:每天10,000次请求
  • 离线阅读需要下载移动应用
  • 免费版中内容的缓存期限为30天