dataify-amazon-comment

Use for Dataify Amazon product review collection Builder tasks. Trigger when the user says or asks for Amazon 产品评论采集工具, Amazon product review collection tool, Amazon comment collection tool, Amazon product review collection, Amazon comment collection, Amazon review scraping, or Amazon comment scraping by URL. Supports creating an amazon_comment_by-url task; returning the task_id; configuring or reusing the DATAIFY_API_TOKEN environment variable; and troubleshooting Dataify Builder request failures.

Submit Amazon product review collection jobs by URL through Dataify Builder, then stop. After a successful submission, give the user the task_id and tell them to visit Dataify to view results.

API TOKEN Handling

Use DATAIFY_API_TOKEN as the long-term saved token name.

• If the user provides a token in the request, use it for this run.
• If no token is provided, first check whether DATAIFY_API_TOKEN is already saved locally in the environment.
• If DATAIFY_API_TOKEN is saved locally, use it.
• If no token is available locally, tell the user to get an API TOKEN from Dataify.
• Do not call the Builder endpoint without a token.
• Always call it API TOKEN in user-facing instructions. Prefer the environment variable name DATAIFY_API_TOKEN for saved local use.

PowerShell examples for saving the token for the current session:

powershell

$env:DATAIFY_API_TOKEN = "YOUR_DATAIFY_API_TOKEN"

For a persistent user-level variable on Windows:

powershell

[Environment]::SetEnvironmentVariable("DATAIFY_API_TOKEN", "YOUR_DATAIFY_API_TOKEN", "User")

Core Workflow

1. Before submitting, show the user the required values, optional values, and defaults listed in the Parameter Checklist.
2. Always display submitted parameters as a Markdown table; do not use a plain sentence or bullet list for parameter confirmation.
3. Ask: "Do you want to change any of these values before I submit the task?"
4. Normalize the final values into url and file_name.
5. Resolve the Dataify token from explicit input or saved DATAIFY_API_TOKEN.
6. If no token is available, tell the user to get an API TOKEN from Dataify.
7. Validate the URL and file name.
8. Submit a Builder request to create the task.
9. Read data.task_id from the Builder response.
10. Tell the user to visit Dataify to view or manage results.

Parameter Checklist

Field	Required	Default	Notes
url	Yes	https://www.amazon.com/HISDERN-Checkered-Handkerchief-Classic-Necktie/dp/B0BRXPR726	Amazon product URL whose reviews should be collected.
file_name	No	{{TasksID}}	Builder form field. Can be changed by the user.

If the user has already provided some values, show those values in place of the defaults and only ask whether the remaining/defaulted values should be changed.

Dataify Builder Request

Use form fields rather than hand-built URL-encoded strings.

• URL: https://scraperapi.dataify.com/builder
• Method: POST
• Authorization header: Bearer DATAIFY_API_TOKEN
• Content type: application/x-www-form-urlencoded
• Fixed fields:
  • spider_name=amazon.com
  • spider_id=amazon_comment_by-url
  • spider_errors=true
• Dynamic fields:
  • spider_parameters must be a JSON string, not a raw object.
  • file_name defaults to {{TasksID}} and can be changed by the user.

Script

For stable execution, prefer scripts/submit_amazon_comment.py with Python 3.6 or newer instead of rewriting the Builder flow. The script writes and reads UTF-8 text.

powershell

python3 ".\scripts\submit_amazon_comment.py"
python3 ".\scripts\submit_amazon_comment.py" --url "https://www.amazon.com/HISDERN-Checkered-Handkerchief-Classic-Necktie/dp/B0BRXPR726" --file-name "amazon-comments"

The script prints a JSON summary with task_id, url, file_name, dashboard_url, and message.

Troubleshooting

Missing Dataify API TOKEN means no explicit token was passed and DATAIFY_API_TOKEN is not saved locally. Tell the user to get an API TOKEN from Dataify.

URL cannot be empty means no usable product URL was provided.

File name cannot be empty means no usable file_name was provided.

Missing task_id usually means the authorization header, token, spider_name, or spider_id is wrong.

Guardrails

• Do not invent result fields.
• Always direct the user to Dataify after successful task creation.