feat(devto): add devto adapter (#234)

* feat(devto): add devto adapter

* refactor(devto): improve adapters to match project conventions

- Make tag/username args positional for natural CLI usage:
  opencli devto tag javascript (instead of --tag javascript)
  opencli devto user ben (instead of --username ben)
- Add rank field (index + 1) matching hackernews/lobsters pattern
- Add tags field from tag_list for richer output
- Remove redundant author column from user command (already filtering by user)
- Use type: str (project convention) instead of type: string
- Increase default limit from 10 to 20 (matching other adapters)
- Update docs with positional arg examples

---------

Co-authored-by: jackwener <jakevingoo@gmail.com>

Author: vkop007

README.md

@@ -141,6 +141,7 @@ Run `opencli list` for the live registry.
 | **bbc** | `news` | Public |
 | **bloomberg** | `main` `markets` `economics` `industries` `tech` `politics` `businessweek` `opinions` `feeds` `news` | Public / Browser |
 | **ctrip** | `search` | Browser |
+| **devto** | `top` `tag` `user` | Public |
 | **arxiv** | `search` `paper` | Public |
 | **wikipedia** | `search` `summary` | Public |
 | **hackernews** | `top` | Public |

README.zh-CN.md

@@ -142,6 +142,7 @@ npm install -g @jackwener/opencli@latest
 | **bbc** | `news` | 公共 API |
 | **bloomberg** | `main` `markets` `economics` `industries` `tech` `politics` `businessweek` `opinions` `feeds` `news` | 公共 API / 浏览器 |
 | **ctrip** | `search` | 浏览器 |
+| **devto** | `top` `tag` `user` | 公开 |
 | **arxiv** | `search` `paper` | 公开 |
 | **wikipedia** | `search` `summary` | 公开 |
 | **hackernews** | `top` | 公共 API |

docs/.vitepress/config.mts

@@ -78,6 +78,7 @@ export default defineConfig({
               collapsed: false,
               items: [
                 { text: 'HackerNews', link: '/adapters/browser/hackernews' },
+                { text: 'Dev.to', link: '/adapters/browser/devto' },
                 { text: 'BBC', link: '/adapters/browser/bbc' },
                 { text: 'Apple Podcasts', link: '/adapters/browser/apple-podcasts' },
                 { text: 'Xiaoyuzhou', link: '/adapters/browser/xiaoyuzhou' },

docs/adapters/browser/devto.md

@@ -0,0 +1,35 @@
+# Dev.to
+
+**Mode**: 🌐 Public · **Domain**: `dev.to`
+
+Fetch the latest and greatest developer articles from the DEV community without needing an API key.
+
+## Commands
+
+| Command | Description |
+|---------|-------------|
+| `opencli devto top` | Top DEV.to articles of the day |
+| `opencli devto tag` | Latest articles for a specific tag |
+| `opencli devto user` | Recent articles from a specific user |
+
+## Usage Examples
+
+```bash
+# Top articles today
+opencli devto top --limit 5
+
+# Articles by tag (positional argument)
+opencli devto tag javascript
+opencli devto tag python --limit 20
+
+# Articles by a specific author
+opencli devto user ben
+opencli devto user thepracticaldev --limit 5
+
+# JSON output
+opencli devto top -f json
+```
+
+## Prerequisites
+
+- No browser required — uses the public DEV.to API

docs/adapters/index.md

@@ -35,6 +35,7 @@ Run `opencli list` for the live registry.
 |------|----------|------|
 | **[hackernews](/adapters/browser/hackernews)** | `top` | 🌐 Public |
 | **[bbc](/adapters/browser/bbc)** | `news` | 🌐 Public |
+| **[devto](/adapters/browser/devto)** | `top` `tag` `user` | 🌐 Public |
 | **[apple-podcasts](/adapters/browser/apple-podcasts)** | `search` `episodes` `top` | 🌐 Public |
 | **[xiaoyuzhou](/adapters/browser/xiaoyuzhou)** | `podcast` `podcast-episodes` `episode` | 🌐 Public |
 | **[yahoo-finance](/adapters/browser/yahoo-finance)** | `quote` | 🌐 Public |

src/clis/devto/tag.yaml

@@ -0,0 +1,34 @@
+site: devto
+name: tag
+description: Latest DEV.to articles for a specific tag
+domain: dev.to
+strategy: public
+browser: false
+
+args:
+  tag:
+    type: str
+    required: true
+    positional: true
+    description: "Tag name (e.g. javascript, python, webdev)"
+  limit:
+    type: int
+    default: 20
+    description: Number of articles
+
+pipeline:
+  - fetch:
+      url: https://dev.to/api/articles?tag=${{ args.tag }}&per_page=${{ args.limit }}
+
+  - map:
+      rank: ${{ index + 1 }}
+      title: ${{ item.title }}
+      author: ${{ item.user.username }}
+      reactions: ${{ item.public_reactions_count }}
+      comments: ${{ item.comments_count }}
+      tags: ${{ item.tag_list | join(', ') }}
+      url: ${{ item.url }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, title, author, reactions, comments, tags]

src/clis/devto/top.yaml

@@ -0,0 +1,29 @@
+site: devto
+name: top
+description: Top DEV.to articles of the day
+domain: dev.to
+strategy: public
+browser: false
+
+args:
+  limit:
+    type: int
+    default: 20
+    description: Number of articles
+
+pipeline:
+  - fetch:
+      url: https://dev.to/api/articles?top=1&per_page=${{ args.limit }}
+
+  - map:
+      rank: ${{ index + 1 }}
+      title: ${{ item.title }}
+      author: ${{ item.user.username }}
+      reactions: ${{ item.public_reactions_count }}
+      comments: ${{ item.comments_count }}
+      tags: ${{ item.tag_list | join(', ') }}
+      url: ${{ item.url }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, title, author, reactions, comments, tags]

src/clis/devto/user.yaml

@@ -0,0 +1,33 @@
+site: devto
+name: user
+description: Recent DEV.to articles from a specific user
+domain: dev.to
+strategy: public
+browser: false
+
+args:
+  username:
+    type: str
+    required: true
+    positional: true
+    description: "DEV.to username (e.g. ben, thepracticaldev)"
+  limit:
+    type: int
+    default: 20
+    description: Number of articles
+
+pipeline:
+  - fetch:
+      url: https://dev.to/api/articles?username=${{ args.username }}&per_page=${{ args.limit }}
+
+  - map:
+      rank: ${{ index + 1 }}
+      title: ${{ item.title }}
+      reactions: ${{ item.public_reactions_count }}
+      comments: ${{ item.comments_count }}
+      tags: ${{ item.tag_list | join(', ') }}
+      url: ${{ item.url }}
+
+  - limit: ${{ args.limit }}
+
+columns: [rank, title, reactions, comments, tags]