New York Times Skill
nytimes
Access premium journalism and news coverage from The New York Times.
SKILL.md
Full skill instructions
New York Times Skill
Access premium journalism and news coverage from The New York Times.
Quick Install
curl -sSL https://canifi.com/skills/nytimes/install.sh | bash
Or manually:
cp -r skills/nytimes ~/.canifi/skills/
Setup
Configure via canifi-env:
# First, ensure canifi-env is installed:
# curl -sSL https://canifi.com/install.sh | bash
canifi-env set NYTIMES_API_KEY "your_api_key"
canifi-env set NYTIMES_EMAIL "your_email"
canifi-env set NYTIMES_PASSWORD "your_password"
Privacy & Authentication
Your credentials, your choice. Canifi LifeOS respects your privacy.
Option 1: Manual Browser Login (Recommended)
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
Option 2: Environment Variables
If you're comfortable sharing credentials, you can store them locally:
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.
Capabilities
- Article Access: Read articles across news, opinion, and feature sections
- Section Browsing: Browse by section including World, Politics, Business, Tech
- Search Archives: Search the complete NYT archive dating back to 1851
- Saved Articles: Save articles to your account for later reading
- Newsletter Management: Subscribe to and manage NYT newsletters
Usage Examples
Get Top Stories
User: "Show me today's top stories from the New York Times"
Assistant: Returns top headlines from the home section
Search Articles
User: "Search NYT for articles about artificial intelligence from the last month"
Assistant: Returns matching articles with headlines and summaries
Browse Section
User: "Show me the latest NYT Technology articles"
Assistant: Returns recent technology section articles
Save Article
User: "Save this NYT article to my account"
Assistant: Saves article to your NYT saved list
Authentication Flow
- Register for API key at developer.nytimes.com
- API key provides access to article search and top stories
- Full article access requires subscription
- Use credentials for authenticated features
Error Handling
| Error | Cause | Solution |
|---|---|---|
| 401 Unauthorized | Invalid API key | Verify API key |
| 403 Forbidden | Subscription required | Subscribe to access full articles |
| 429 Rate Limited | API limit exceeded | Wait and retry with backoff |
| 404 Not Found | Article not found | Check article URL or ID |
Notes
- Free API tier: 500 requests/day, 5 requests/minute
- Subscription required for full article access
- Archive API covers 1851 to present
- Games and Cooking require separate subscriptions
- Wirecutter reviews included with subscription