Feature Request: Twitter likes list command

[poer2023]

Feature Description

Currently, opencli has a twitter like command to like a specific tweet, but there's no command to fetch a user's liked tweets list (similar to bookmarks, timeline, followers, etc.).

Use Case

As a user, I want to retrieve the list of tweets that a specific Twitter user has liked, which is useful for:

• Analyzing user interests and preferences
• Backing up liked content
• Content curation and research

Expected Behavior

opencli twitter likes <username> --limit 20

Should return a list of tweets that the specified user has liked, similar to how bookmarks and timeline work.

Technical Details

I've found that Twitter's GraphQL API has a Likes endpoint:

• Query ID: RozQdCp4CilQzrcuU0NY5w
• Endpoint: /i/api/graphql/{queryId}/Likes
• Parameters: userId, count, cursor (for pagination)

The API structure is similar to the existing bookmarks and timeline commands.

Question

Is there a specific reason why this feature hasn't been implemented yet? Are there any technical limitations or API restrictions I should be aware of?

I'm happy to contribute a PR if this feature would be welcomed.

[Astro-Han]

Thanks for the well-structured proposal!

A likes command fits naturally into the existing Twitter adapter lineup. Since you've already identified the GraphQL endpoint, here are some pointers to make your PR smooth:

Reference implementation

bookmarks.ts is the closest analog — the likes command shares the same pattern:

• Auth: Strategy.COOKIE + ct0 CSRF token (same as bookmarks/timeline)
• QueryId resolution: fetch from fa0311/twitter-openapi placeholder.json (Likes key), fallback to your hardcoded ID
• Response parsing: timeline-style entries with cursor pagination
• Tweet extraction: reuse the same extractTweet pattern (rest_id, legacy, core.user_results)

Key differences from bookmarks

1. Requires userId — you'll need to resolve username → userId first (see profile.ts for the UserByScreenName query pattern)
2. Response envelope — likely data.user.result.timeline_v2.timeline.instructions instead of data.bookmark_timeline_v2
3. Privacy — Twitter may restrict likes visibility for some users; handle gracefully with a clear error message

Suggested interface

opencli twitter likes <username> --limit 20

With username as a positional arg (like followers/following).

Checklist

Before submitting, please review:

• CONTRIBUTING.md for PR conventions
• TESTING.md for test placement decisions

Welcome your PR! 🙌