nexscope-ai/eCommerce-Skills / review-checker/ebay-review-checker
ebay-review-checker
VerifiedeBay review and feedback authenticity analyzer. Detect fake reviews, suspicious seller feedback patterns, and buyer manipulation. Includes time clustering detection, content similarity analysis, and eBay-specific red flag identification. No API key required.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.5 KB |
| scripts/analyzer.py | script | 27.8 KB |
| scripts/parser.py | script | 9.9 KB |
| scripts/report_html.py | script | 13.5 KB |
scripts/parser.py
View on GitHub#!/usr/bin/env python3
"""
Review Parser - Multi-format Input Parser
ReviewParse - many FormatInputParse
SupportFormat:
- pureText (Paragraph separator)
- JSON
- CSV
- TSV
- Markdown Table
Version: 1.0.0
"""
import json
import csv
import re
from typing import List, Optional
from dataclasses import dataclass
from io import StringIO
@dataclass
class Review:
"""Single itemReview"""
content: str
rating: Optional[int] = None
date: Optional[str] = None
reviewer_name: Optional[str] = None
verified_purchase: Optional[bool] = None
helpful_votes: Optional[int] = None
reviewer_reviews_count: Optional[int] = None
class ReviewParser:
""" many FormatReviewParse"""
@staticmethod
def detect_format(text: str) -> str:
"""DetectionInputFormat"""
text = text.strip()
# JSON group
if text.startswith('[') and text.endswith(']'):
try:
json.loads(text)
return 'json'
except:
pass
# JSON Object
if text.startswith('{'):
try:
json.loads(text)
return 'json_single'
except:
pass
# CSV (CheckComma separated with header)
lines = text.split('\n')
if len(lines) > 1:
first_line = lines[0].lower()
if ',' in first_line and any(h in first_line for h in ['content', 'review', 'rating', 'date', 'text']):
return 'csv'
# TSV
if len(lines) > 1 and '\t' in lines[0]:
return 'tsv'
# Markdown Table
if '|' in text and '---' in text:
return 'markdown'
# DefaultpureText
return 'text'
@staticmethod
def parse(text: str) -> List[Review]:
"""ParseReview"""
format_type = ReviewParser.detect_format(text)
parsers = {
'json': ReviewParser.parse_json,
'json_single': ReviewParser.parse_json_single,
'csv': ReviewParser.parse_csv,
'tsv': ReviewParser.parse_tsv,
'markdown': ReviewParser.parse_markdown,
'text': ReviewParser.parse_text,
}
parser = parsers.get(format_type, ReviewParser.parse_text)
return parser(text)
@staticmethod
def parse_json(text: str) -> List[Review]:
"""Parse JSON group"""
try:
data = json.loads(text)
reviews = []
for item in data:
review = Review(
content=item.get('content', item.get('text', item.get('review', ''))),
rating=item.get('rating', item.get('stars', item.get('star'))),
date=item.get('date', item.get('review_date')),
reviewer_name=item.get('reviewer_name', item.get('author', item.get('name'))),
verified_purchase=item.get('verified_purchase', item.get('vp', item.get('verified'))),
helpful_votes=item.get('helpful_votes', item.get('helpful')),
)
if review.content:
reviews.append(review)
return reviews
except:
return []
@staticmethod
def parse_json_single(text: str) -> List[Review]:
"""ParseSingle JSON Object"""
try:
item = json.loads(text)
review = Review(
content=item.get('content', item.get('text', item.get('review', ''))),
rating=item.get('rating', item.get('stars')),
date=item.get('date'),
reviewer_name=item.get('reviewer_name', item.get('author')),
verified_purchase=item.get('verified_purchase', item.get('vp')),
)
return [review] if review.content else []
except:
return []
@staticmethod
def parse_csv(text: str) -> List[Review]:
"""Parse CSV"""
reviews = []
try:
reader = csv.DictReader(StringIO(text))
for row in reader:
# TryMultipleField name
content = (
row.get('content') or row.get('Content') or
row.get('review') or row.get('Review') or
row.get('text') or row.get('Text') or
row.get('review_text') or row.get('body') or ''
)
rating_str = (
row.get('rating') or row.get('Rating') or
row.get('stars') or row.get('Stars') or
row.get('star') or ''
)
rating = None
if rating_str:
try:
rating = int(float(rating_str))
except:
pass
date = (
row.get('date') or row.get('Date') or
row.get('review_date') or row.get('created_at') or None
)
vp_str = (
row.get('verified_purchase') or row.get('vp') or
row.get('verified') or row.get('VP') or ''
)
vp = None
if vp_str:
vp = vp_str.lower() in ['true', 'yes', '1', 'y', 'verified']
reviewer = (
row.get('reviewer_name') or row.get('author') or
row.get('name') or row.get('reviewer') or None
)
if content:
reviews.append(Review(
content=content,
rating=rating,
date=date,
reviewer_name=reviewer,
verified_purchase=vp,
))
except Exception as e:
print(f"CSV parse error: {e}")
return reviews
@staticmethod
def parse_tsv(text: str) -> List[Review]:
"""Parse TSV"""
# Convert to CSV FormatProcess
csv_text = text.replace('\t', ',')
return ReviewParser.parse_csv(csv_text)
@staticmethod
def parse_markdown(text: str) -> List[Review]:
"""Parse Markdown Table"""
reviews = []
lines = text.strip().split('\n')
# find to Tablehead
header_line = None
data_start = 0
for i, line in enumerate(lines):
if '|' in line and '---' not in line:
header_line = line
data_start = i + 2 # Skip separator lines
break
if not header_line:
return []
# ParseTablehead
headers = [h.strip().lower() for h in header_line.split('|') if h.strip()]
# ParseDatarow
for line in lines[data_start:]:
if '|' not in line:
continue
cells = [c.strip() for c in line.split('|') if c.strip()]
if len(cells) < len(headers):
continue
row = dict(zip(headers, cells))
content = row.get('content', row.get('review', row.get('text', '')))
rating = None
rating_str = row.get('rating', row.get('stars', ''))
if rating_str:
try:
rating = int(float(rating_str.replace('★', '').strip()))
except:
pass
if content:
reviews.append(Review(
content=content,
rating=rating,
date=row.get('date'),
reviewer_name=row.get('author', row.get('reviewer')),
))
return reviews
@staticmethod
def parse_text(text: str) -> List[Review]:
"""ParsepureText"""
reviews = []
# TrySplit by paragraph
paragraphs = re.split(r'\n\n+', text.strip())
for para in paragraphs:
para = para.strip()
if len(para) < 10:
continue
review = Review(content=para)
# TryExtract starLevel
star_patterns = [
r'(\d)\s*(?:star|stars|★|⭐)',
r'(?:star|stars|rating)[:\s]*(\d)',
r'^(\d)★',
r'^(\d)\s*star',
]
for pattern in star_patterns:
match = re.search(pattern, para, re.I)
if match:
review.rating = int(match.group(1))
break
# TryExtractDayPeriod
date_patterns = [
r'(\d{4}-\d{2}-\d{2})',
r'(\w+\s+\d{1,2},?\s+\d{4})',
r'(\d{1,2}/\d{1,2}/\d{4})',
]
for pattern in date_patterns:
match = re.search(pattern, para)
if match:
review.date = match.group(1)
break
# TryExtract VP Status
if re.search(r'verified\s*purchase', para, re.I):
review.verified_purchase = True
elif re.search(r'not\s*verified', para, re.I):
review.verified_purchase = False
reviews.append(review)
return reviews
def parse_reviews(text: str) -> List[Review]:
"""ConvenientFunction"""
return ReviewParser.parse(text)
# CLI
if __name__ == "__main__":
import sys
if len(sys.argv) > 1:
text = sys.argv[1]
else:
# TestData
text = """
content,rating,date,verified_purchase
"Great product!",5,2024-01-15,true
"Not good",2,2024-01-16,false
"Amazing!",5,2024-01-17,true
"""
reviews = parse_reviews(text)
print(f"Parsed {len(reviews)} reviews:")
for r in reviews:
print(f" - {r.rating}★ | VP:{r.verified_purchase} | {r.content[:50]}...")
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |