Align the provider with competitor X reads and writes.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: lanbytes

.github/workflows/release.yaml

@@ -23,6 +23,7 @@ jobs:
         with:
           gpg_private_key: ${{ secrets.TERRAFORM_GPG_SECRET_KEY }}
           passphrase: ${{ secrets.TERRAFORM_GPG_PASSPHRASE }}
+          git_user_signingkey: false
       - uses: goreleaser/goreleaser-action@v6
         with:
           args: release --clean

.gitignore

@@ -8,6 +8,7 @@ crash.log
 .DS_Store
 .env
 .env.local
+.secrets/
 **/.speakeasy/temp/
 **/.speakeasy/logs/
 .speakeasy/reports

README.md

@@ -1,20 +1,22 @@
 # TwexAPI Terraform Provider: Twitter API for search, followers, DMs & X automation
 
-Use the TwexAPI Terraform provider to read X profiles and account balance, follow accounts, and post tweets.
+Use the TwexAPI Terraform provider to read X profiles and tweets, follow accounts, and post, like, retweet, or bookmark.
 It wraps the [Go SDK](https://github.com/twexapi-dev/x-api-scraper-go). Search, timelines, DMs, communities, and other reads stay on the REST API or language SDKs.
 
 [REST API](https://docs.twexapi.io) | [Go SDK](https://github.com/twexapi-dev/x-api-scraper-go) | [TypeScript SDK](https://github.com/twexapi-dev/x-api-scraper-typescript) | [Dashboard](https://twexapi.io/dashboard)
 
-This provider is a thin Terraform Plugin Framework wrapper. Speakeasy does not generate Terraform on the current TwexAPI workspace plan.
+This provider is a thin Terraform Plugin Framework wrapper over the Go SDK, the same approach as the competitor provider.
 
 ## Common Twitter & X tasks
 
 | Task                            | REST Route                          | Terraform                                          |
 | ------------------------------- | ----------------------------------- | -------------------------------------------------- |
 | Read an X profile               | `GET /twitter/{screen_name}/about`  | `data.x-api-scraper_user_about`                    |
+| Read a tweet                    | `POST /twitter/tweets/lookup`       | `data.x-api-scraper_tweet`                         |
 | Read TwexAPI account balance    | `GET /balance`                      | `data.x-api-scraper_account`                       |
 | Follow an account               | `POST /twitter/user/follow`         | `x-api-scraper_follow`                             |
 | Post or reply                   | `POST /twitter/tweets/create`       | `x-api-scraper_tweet`                              |
+| Like / retweet / bookmark       | tweet action routes                 | `x-api-scraper_like`, `_retweet`, `_bookmark`      |
 | Search tweets without the X API | `POST /twitter/advanced_search/page` | Use the [Go SDK](https://github.com/twexapi-dev/x-api-scraper-go) |
 
 ## Package & registry trust
@@ -25,6 +27,7 @@ This provider is a thin Terraform Plugin Framework wrapper. Speakeasy does not g
 - Docs: [docs.twexapi.io](https://docs.twexapi.io)
 - License: MIT
 - Dashboard: [twexapi.io/dashboard](https://twexapi.io/dashboard)
+- Release signing key: [`gpg-public.asc`](./gpg-public.asc)
 
 ## Install
 
@@ -107,4 +110,15 @@ resource "x-api-scraper_tweet" "announcement" {
 
 Changing `tweet_content` replaces the resource. Destroy deletes the tweet.
 
+## Like, retweet, or bookmark
+
+```hcl
+resource "x-api-scraper_like" "example" {
+  tweet_id = data.x-api-scraper_tweet.example.tweet_id
+  cookie   = var.twitter_cookie
+}
+```
+
+Destroy reverses the action.
+
 Not affiliated with X Corp.

docs/data-sources/tweet.md

@@ -0,0 +1,32 @@
+---
+page_title: "x-api-scraper_tweet Data Source"
+---
+
+# x-api-scraper_tweet
+
+Read a tweet by id. Maps to the competitor `x_tweet` data source.
+
+## Example Usage
+
+```hcl
+data "x-api-scraper_tweet" "example" {
+  tweet_id = "20"
+}
+```
+
+## Schema
+
+### Required
+
+- `tweet_id` (String)
+
+### Read-Only
+
+- `text` (String)
+- `created_at` (String)
+- `screen_name` (String)
+- `user_id` (String)
+- `favorite_count` (Number)
+- `retweet_count` (Number)
+- `reply_count` (Number)
+- `data_json` (String) Raw tweet payload as JSON.

docs/data-sources/user_about.md

@@ -4,7 +4,7 @@ page_title: "x-api-scraper_user_about Data Source"
 
 # x-api-scraper_user_about
 
-Read an X profile by screen name.
+Read an X profile by screen name. Maps to the competitor `x_user` data source.
 
 ## Example Usage
 
@@ -27,3 +27,7 @@ data "x-api-scraper_user_about" "example" {
 - `avatar` (String)
 - `created_at` (String)
 - `is_blue_verified` (Boolean)
+- `verification` (Boolean)
+- `account_based_in` (String)
+- `affiliate_username` (String)
+- `username_changes_count` (Number)

docs/index.md

@@ -5,7 +5,7 @@ description: Terraform provider for TwexAPI Twitter search, followers, DMs, and
 
 # TwexAPI Provider
 
-Manage a small set of TwexAPI reads and writes as Terraform resources. Use a language SDK for search and pagination.
+Manage TwexAPI reads and writes as Terraform data sources and resources. It wraps the Go SDK. Search and pagination stay on the language SDKs.
 
 ## Example Usage
 

docs/resources/bookmark.md

@@ -0,0 +1,27 @@
+---
+page_title: "x-api-scraper_bookmark Resource"
+---
+
+# x-api-scraper_bookmark
+
+Bookmark a tweet. Destroy removes the bookmark.
+
+## Example Usage
+
+```hcl
+resource "x-api-scraper_bookmark" "example" {
+  tweet_id = "20"
+  cookie   = var.twitter_cookie
+}
+```
+
+## Schema
+
+### Required
+
+- `tweet_id` (String)
+- `cookie` (String, Sensitive)
+
+### Read-Only
+
+- `id` (String)

docs/resources/like.md

@@ -0,0 +1,27 @@
+---
+page_title: "x-api-scraper_like Resource"
+---
+
+# x-api-scraper_like
+
+Like a tweet. Destroy unlikes it.
+
+## Example Usage
+
+```hcl
+resource "x-api-scraper_like" "example" {
+  tweet_id = "20"
+  cookie   = var.twitter_cookie
+}
+```
+
+## Schema
+
+### Required
+
+- `tweet_id` (String)
+- `cookie` (String, Sensitive)
+
+### Read-Only
+
+- `id` (String)

docs/resources/retweet.md

@@ -0,0 +1,27 @@
+---
+page_title: "x-api-scraper_retweet Resource"
+---
+
+# x-api-scraper_retweet
+
+Retweet a tweet. Destroy deletes the retweet.
+
+## Example Usage
+
+```hcl
+resource "x-api-scraper_retweet" "example" {
+  tweet_id = "20"
+  cookie   = var.twitter_cookie
+}
+```
+
+## Schema
+
+### Required
+
+- `tweet_id` (String)
+- `cookie` (String, Sensitive)
+
+### Read-Only
+
+- `id` (String)

examples/basic/main.tf

@@ -12,6 +12,14 @@ data "x-api-scraper_user_about" "example" {
   screen_name = "elonmusk"
 }
 
+data "x-api-scraper_tweet" "example" {
+  tweet_id = "20"
+}
+
 output "user_id" {
   value = data.x-api-scraper_user_about.example.user_id
 }
+
+output "tweet_text" {
+  value = data.x-api-scraper_tweet.example.text
+}